SB 180 

Computer/Controiler 


DATA SHEET 




DESCRIPTION 

The MICROMINT SB180 computer packs a lot of compu- 
ting power in a very small package. The SB180, only 4" 
by ly^' , offers a Z-80 compatible CPU running at 6MHz, 
256K bytes of RAM, up to 32K bytes of ROM, two 
serial ports, a parallel port, expansion bus, and an industry 
standard 765A-compatlble disk controller for up to four 
disk drives - any combination of 3727 5/4", or 8" drives. 
Whether you use the SB180 as the basis for a complete 
disk based computer system or use Its 32K of ROM space 
for a battery-powered dedicated controller application pro- 
gram, you will appreciate Its ability to run standard 8080/ 
8085 and Z-80 software at up to twice the speed of a 
4MHz Z-80. 


The SB180 uses the most powerful of the new generation 8 bit CPUs — the Hitachi HD64180. The HD64180 is based 
on a microcoded execution unit and advanced CMOS manufacturing technology. It provides the benefits of high perfor- 
mance, reduced system cost and low power operation while maintaining complete compatibility with the large base of 
standard CP/M software. Performance of the HD64180 derives from its high clock speed, instruction pipelining, and an 
integrated Memory Management Unit (MMU) with 51 2K bytes memory address space. The instruction set is a superset of 
the Z80 instruction set; twelve new instructions include hardware multiply and a SLEEP Instruction for low power op- 
eration System costs are reduced because many key system functions have been included on-chip. Besides the MMU, 
the HD64180 boasts a two channel Direct Memory Access Controller (DMAC), wait state generator, dynamic RAM 
refresh, two channel Asynchronous Serial Communication Interface (ASCI), Clocked Serial I/O port (CSI/0), two 
channel 16-bit Programmable Reload Timer (PRT), a versatile 12 source interrupt controller, and a "dual" (68xx 
and 80xx families) bus interface. 

C Because the SB180 uses the Z80 instruction set, it can run CP/M 2.2, CP/M Plus, Z-System, MP/MEL, TurboDOS, 
)and Oasis operating systems. These operating systems can be custom configured to make use of the 256K bytes on 
board memory for enhanced performance. And popular program development tools for these operating systems ~ 
BASIC, FORTRAN, Pascal, PL/1, C, Forth, assembler, etc. — are widely available; thousands of proven application 
programs will work, too. 



TECHNICAL SPECIFICATIONS 


PROCESSOR 


FLOPPY DISK INTERFACE 


* Hitachi HD64180, an 8-bit CPU on a 64 pin chip 

* Superset of Z-80 instruction set, including 
hardware multiply 

* Integrated Memory Management Unit with 512K 
bytes address space 

* Dynamic RAM refresh 

* Wait state generator 

* Clocked serial I/O port 

* 2 channel Direct Memory Access Controller 

* 2 channel Asynchronous Serial Communication 
Interface 

* 2 channel 16-bit Programmable Reload Timer 

* 12 interrupts 

* Dual bus interface to 68xx and 80xx support chips 
*6.1 MHz system clock 


Uses Standard Microsystems 9266 disk controller chip 

Compatible with NEC 765A controller 

On-chip digital data separator 

Can control 372", 5%", and 8" drives — up to 4 in 

any combination 

Handles both FM encoded (single density) and 
MFM encoded (double density) data 


POWER SUPPLY REQUIREMENTS 

* +5 volts 5% @ 300 mA (all CMOS); @ 500mA (TTL) 

* -1-12 volts +/- 20% @ 40 mA (plus disk drive requirements) 

DIMENSIONS AND CONNECTIONS 


MEMORY 

* 256K bytes dynamic RAM on board 

* Either an 8K 2764, 16K 27128, or 32K 27256 
EPROM usable 

* Optional full function 8K ROM monitor 




INPUT/OUTPUT 


IJ 


Console I/O RS-232 serial port with auto-baud 

rate select to 19,200 baud 

Peripheral RS-232 serial port, full handshaking, 

150-19,200 baud 

Line printer parallel I/O port 

19-bit address decoding, I/O port decoding, 

and dual bus interface brought out to 

expansion bus connector 


* 4" by lyy board with mounting holes 

* 20 pin DIP header for RS-232C serial console I/O 

* 20 pin DIP header for RS-232C serial peripheral port 
20 pin DIP header for parallel port line printer 

* 34 pin header for 372" or 5%" floppy disk 
Layout for 40 pin and 8 pin headers (unpopulated) 
for|H||| expansion bus 

Layouwor 50 pin header (unpopulated) for 8" floppy disks 

OPERATING CONDITIONS 

* Temperature: 0-50 C (32-122 F) 

* Relative humidity: 10-90% relative humidity, non-condensing 


COMPUTER/CONTROLLER SERIES 



THE MICROMINT ROM MONITOR 


The ROM monitor provided with the SB180 is a complete set of utilities and debugging aids in an 8K byte EPROM 
which supports four I/O ''devices": 

CON: - Console RS-232 serial port CEN: — Centronics parallel printer port 

AUX: — Auxiliary RS-232 serial port DSK: — Floppy disk storage device 


Monitor Commands include: 


A — ASCI I table 
B — Bank select 
C — Copy disk 
D — Display memory 
E — Emulate terminal 
F — Fill memory 
^ — Goto program 
H — Hexmath 


I — Input port 
K— Klean d isk (format) 
M— Move memory 
N — New command 
O— Output port 
P— Printer select 
Q— Query memory 
R— Read Disk 


S — Set memory 
T — Test system 
U— Upload hex file 
V— Verify memory 
W— Write disk 
X— eXamine CPU registers 
Y— Yank I/O registers 
Z— Z- System boot 



• Z-SYSTEM DISK • 
OPERATING SYSTEM 

The Z-System is an enhanced 8-bit 
operating system which is a com*/ 
plete replacement for CP/M . ,2.2 f 
from Digital Research. Any 6f tbe j 
thousands of application programs/ ' 
languages, or utilities whfjDb run - 
under CP/M wHl also run un3^f 
Z*Sy stern. Z-System ?s a ad- / 
vanced, more cphvenlent oj^eratih^ V 
environment thap CP/M/vvitH rrfe 
utility progranris which giye tfeiiset 
more consistent, easier access to its:; 
features. Named dlre^ctpff^s am prp- : 
vided rather than disk drive desigrra- 
tors and user areas. Mu hjpfe gonv 
mands may be entered on; th^ cbm'' 
mand line. A sophisticated "search 
path" is implemented for programs/ 
and files. Input/outpiif fedifection ' 
is supported. Password protection; ; 
for directory access is available, :and; 
user privilege levels ior ; 

can be provided/Z-System has been 
customized to make uso of the 
SBIBO's expand^^ instructipn/set, 
making it very fast and e?<tremeJy 
efficient. - '/ ; 


Comparison of the SB 180's Z-System, CP/M-80, and MS-DOS 


FEATURE 


'Vv;^>CP/M 

Z-Sy$tem . / -2.2 


MS-DOS 


Softvyar^ compatible with CP/M 2.2 : . ♦ / f C : 

, No warm boot required vyhw changing dfeks * • 

/Mulfipfecbmmafufs'f^rft ' / /-•', 

{framed, directories/'^'//”'-'/'''-- •/ 7 ///-. / /'/ / 

■ f^ts;sv¥ora'(jroteetjbn'',fqrdifect(U-(es' ' . ,■ v / 

OynamfMliyyari^lfl useV privily • 

Searching df alternate aifiepWfiesfof invoked pfqgr^ : \ ^ v/ p 

\.andf,Hes- ,■ ' 

rtefmWal^ndepeodent Video capabiVrt^ ♦ 

Hnptit/oatp^ytj^irect^ ':/ '-.7 ''/-''-'/J. /.7 - 

Cohditiohhl testing and executioMt the operating , , : : 

system .level OF/EtSE/END IF)' ■/, ^ ' o - ■ 

Shellsapd menu generator? With shelf variables 'if ' ^ , 

Tree'StructutddonTrpehVlpand ddcum # 

S12mo9abytHne $ize5/8gi§ahytB disk^^;7// ♦ 

Complete error trapping Vith recoydryi customizable^ / , ^ ^ ; ; 

messages and ptomgts,'/-, ’/"./.'V.v!''''-'''.'".''.; ' 

Screeri'Onepted fif? ^ 

/ "and backup /,;/////' -'Z' 'V'///'//'' / -/' 7/'7'7 . 7 ' '-'v'"' ^ 

F^ifl screen com;rnand Bne editing with preylbUi coniipand ^ 

- recall and BKecut ion'/;,; ' ./'7/:'';7//7// - '/' / 


# ^ Yes 




PART # DESCRIPTION PRICE 

SB180-1 SBl 80 computer board W/256K $369.00 

bytes RAM and ROM monitor. 

SB180-10 SB180 Boot disk. Contains $ 49.00 

Z-System with limited utilities 
and Super Bios source listing. 

Provided on 514" SB 180 format 
DSDD diskette. 


SB180-20 Z-System including ZR DOS, $190.00 
ZCPR3, editor, utilities, ZAS 
assembler, and ZDM debugger 
on four 514" DSDD disks. 


All boards are complete with the exception of the 50 pin 8" drive header 
44/8 pin expansion bus headers which are not populated and optionally 
available. Printer, disk, and terminal cables available separately. Call for 
pricing. OEM terms available. 


CP/M and CP/M-80 are registered trademarks of Digital Research, Incorporated 
MS-DOS is a registered trademark of Microsoft, Inc. 

Z80 is a registered trademark of Zilog, Inc. 

Z-System is a registered trademark of Echelon, Inc. 

ZCPR3 Copyright (c) R.L. Conn 



Order Toll Free 

1800 6353355 


In Connecticut call: T871-6170 


To order or for more information, 
call TOLL FREE or write: 

MICROMINT, INC. 

25 Terrace Drive, Vernon, CT 06066 


# COMPUTER/bONTROLLER SERlOS 




DATA SHEET 


COMM 180 

Modem/SCSI Peripheral Board 


DESCRIPTION 

The MICROMINT COMM180 expansion 
board may be the only board you will 
ever need for your SB 180 computer. This 
4" X 5" board adds two major functions 
to your SB180: 

1 ) Bell 1 03-2 1 2 A compatible 300/1200 
baud modem with Dual Tone Multi- 
Frequency (DTMF) encode/decode 
capability and voice synthesis. 

2) SCSI hard disk controller interface. 

The COMM180 board is available in 
three versions: 

1) Modem, DTMF encode/decode, and 
voice synthesis alone. 

2) Smal! Computer System Interface 
(SCSI) hard disk controller inter- 
face alone. 

3) Both of the above. 

And either the modem version or the 
SCSI controller version may be upgraded 
to the full version at any time. 

The COMM180 does not use a serial port on the SB180, but instead addresses the bus directly. It is fully Bell 103 and 
.^ell 21 2A compatible (including FCC registered Data Access Arrangement) for 300 and 1200 baud use, is 8251 A 
pftware compatible, features both DTMF and pulse dialing, call progress monitoring, DTMF reception and decoding, 
^nd a unique diagnostic capability which automatically compensates for common telephone line deficiencies. In 
addition the COMM180 has voice synthesis capabilities which allow It to respond verbally to commands entered 
via the standard touch tone telephone pad. 

The SCSI allows the use of a wide variety of hard disks with the SB180 for fast, sophisticated mass storage whether 
you need just 5 megabytes or 50 megabytes. Many manufacturers offer hard disk drives and controller cards which 
mate with the SCSI interface. If you need more file space than floppies allow, the COMM180 board can help meet your 
storage needs. In addition, many laboratory instruments support the SCSI standard, thus the COMM180 can allow 
the SB 180 to be more easily used for data logging and data reduction. 

Software for the COMM180-M includes TERM III, a complete modem communications system designed to run 
under Z-System DOS available for the SB180. BIOS modifications are supplied in source code to allow Integrations of 
hard disk drivers into the Z-System DOS. 




TECHNICAL SPECIFICATIONS 


MODEM 

Plugs into the Expansion Bus on the SB180 

* Only 4" X 5"' 

Fully Bell-212A and Bell-103 Compatible 

* DTMF or Pulse Dialing 

* Jack for External Speaker for Call 
Progress Monitoring 

DTMF Reception and Decoding 

* 8251 A Software Compatibility 
Parity Generation/Checking 
Sync Byte Detection/Insertion 

* Synchronous 1200 bps. Asynchronous 
1200, 300, 110 bps 


SCSI 

Provides a Device Independent Local I/O Bus 
Operates at DMA Data Rates Up to 1.5 
Megabytes Per Second 
Supports Initiator and Target Roles 
Parity Generation with Optional Checking 


Software Controlled Audio Input and 
Output Interface (2 Separate Jacks) 
for Voice Communication or Acoustic 
Coupling 

Voice Synthesis (LPC coded) 

* ASCII Command and Error/Status Codes 
Extensive Built in Diagnostics 

* Phone Line Diagnostics 

* FCC Registered Direct Connection. 

Tip and Ring Input 


Supports Bus Arbitration 
Provides Direct Control of All Bus Signals 
XEBEC 1410 compatible 
* ADAPTEC ACB4000 compatible 







COMM180 SOFTWARE 


The software which comes with the GOMMISO-M consists of TERM III and Z-MSG (optional). 

TERM III is a sophisticated communications package which offers all the functions of standard 
modem programs but goes far beyond them when used with COMM 180's advanced features and 
Z-System DOS (required for operation). TERM III was designed to be used as: 

1) an originating communications system to allow the user to dial out, communicate with other 
computers, and perform file transfer functions; 

2) a remote access system to allow users to dial into the system, interact with it, and transfer 
programs into and out of it; and, 

3) a configuration system to allow the user to configure the attributes of the other two types 
of systems. 

TERM 111 offers multiple file transfer protocols: Christiansen's MODEM? (with checksum and with 
CRC), MODEM? batch, XMODEM, KERMIT, CompuServe's CIS, and X-ON/X-OFF. Special attention 
has been paid to making the remote access system completely secure from unauthorized use. You 
may also patch subroutines into TERM III to use a standard touch tone pad to give special 
instructions, or run a program using the COMM 180's speech synthesis with verbal system access. 

Z-MSG allows the COMM 180, SB 180, and TERM III to be custom configured as a "turnkey" 
Remote Bulletin Board System - either as a public system allowing access to anyone or as a private 
system restricting access to "members only". Z-MSG allows up to eight user "types" with varying 
privileges associated with each. Messages may be public or private and may be over 100 lines long. 
Extensive editing functions are provided and comprehensive on-line help is always available. 

For those wishing to use the SCSI as a hard disk controller, source code is provided which allows 
many types and sizes of Winchester disks to be used as mass storage for the SB180. Of course, the 
SCSI may also be used to link other SB180's or SCSI equipment together as well. 


. 0 ^ 


COMM180 PRICING 

Item 1: COMM180-S SCSI board with BIOS upgrade. 

Item 2: COMM 1 80- M 1200 baud modem board with TERM III. 

Item 3: COMM180-M-S combination modem/SCSI board with TERM II 
and BIOS upgrade. 

Item 4: Z-MSG turnkey bulletin board software for the COMM180-M. — \C>^ 




Call MIcromInt for current price information 



Order Toll Free 

1800 6353355 

In Connecticut call: 1-871-6170 



We welcome the opportunity to offer quantity pricing and OEM proposals. 

To order or for more information, call TOLL FREE or write: 
MICROMINT, INC. 25 Terrace Drive, Vernon, CT 06066 

9/85 




PS- AS TEC 

AA12nO 


INPUT: 

115 or 230 VAC + or - 16% 
0.85 Amp RMS max. 


FUSE; 

5 MF 2 A 125 V or 
5 MF 1 A 250 V 


OUTPUT: 

+5 V + or - 5% 2.5 Amp’ 50 mVp-p max. ripple 
+12 V + or - 5% 2.0 Amp 150 mVp-p max. ripple 
-12 V + or - 25% 0.1 Amp 150 mVp-p max. ripple 

* 5.0 Amps if no load on +12 V 


MAX. POWER OUTPUT; 
38 watts 
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TIP SHEET 


10/23/85 


First time users may find the following list of tips useful in 
setting up and using their system: 

1) The system provided must be booted on a double-sided- 
double-density 48 tpi disk drive with the terminal set for 9600 
baud. The system may later be configured by the user to boot 
from 96 tpi drives and at a different baud rate. (Use CONFIG to 
change the baud rate.) 

2) ZCPR3 allows the use of up to 32 user areas on each disk. 
(The system provided has been set up to use areas 0 through 15 
only. Should the user need more areas than this, the system 
source files on disk three must be modified and reassembled.) 
The different areas may be accessed by typing the desired area 
number followed by a colon and a return at the system prompt. 
For example, to move from area 0 to area 15 type '15:' at the 
'A0:BASE>' prompt. 

3) A user area may also have a name associated with it. 
When the 'System Master' disk is used to boot the system, user 
area 0 is named 'BASE' while area 15 is named 'ROOT'. To move 
between areas using their names, type the area name instead of 
its number, followed by a colon and a return. Another way to 
move to area 15 in the above example is to type 'ROOT: ' at the 
'A0:BASE>' prompt. 

4) To see a list of currently defined named directories, 

followed by a return. To get a list of all the files 
on a disk in all the user areas, put the disk in drive B: and 
type * XDI R B : U ' followed by a return. (SB180-20 software only.) 

5) All of the files on disks two, three, and four may be 
found in user area 0. (SB180-20 software only.) However, most of 
the files on disk one are in user area 15. This is so the user 
doesn't have to see a list of system tools every time he does a 
directory. 

6) As provided, the system uses a disk head step rate of 
10ms. (If this means nothing to you, go on to the next para-* 
graph.) A quicker step rate may be used with some drives to 
increase the overall disk access rate. Check your disk drive's 
manual to determine if a faster step rate can be used. (e.g. 
_T EAC FD-5 5B-2 0-U d rives use a 6ms step rate.) Run CONFIG to 
make this change. “ 

7) Besides the system tools on the 'System Master® disk, 
there are also a number of built-^in commands. These include 
commands in the command processor (CP) , which are GO, SAVE, GET, 
JUMP, and NOTE, and com.raands in the resident command package 
(RCP) such as TYPE and POKE. For a list of RCP commands , type H 
at the system prompt. For more details, see the ZCPR3 book. 
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8) If you plan to mount your SB180 in an enclosure, be sure 
to use nylon or plastic washers between any metal hardware and 
the SBlSO's circuit board. Any metal allowed to touch the board 
my cause short circuits and prevent the board from operating 
proper ly . 

9) If you have a printer plugged into your system, be sure 
the power on the printer is turned on before booting the system. 
If the printer is turned off when the computer is turned on, the 
system may hang and refuse to boot until the printer is unplugged 
or turned on. 

10) The table in the manual describing the correct jumpering 
for a TEAC 55B drive is for a TEAC FD-55B^20-U drive. We have 
found at least two other 558 drives which need different jumpers 
installed. Also, the TEAC 55F 80-track drive has its own set of 
required jumpers. These are listed below: 

TEAC FD-55B-20-U 

install ML, UR, DSx, and terminators 
TEAC FD-55B-01-U 

install HL, UR, PM, DSx, and terminators 
— TEAC FD-55BV-06-U 

install HL^. RY, DSx, and terminators 


TEAC FD-55F-03-U 

install HL, UR, PM, DSx, and terminators 

(Terminators should be installed only on the last 
drive on your cable. The DSx designation above refers 
to the DSO, DSl, DS2, or DS3 jumper, depending on 
whether you are configuring drive A:, B:, C: , or D: . ) 

11) There are over 40 remote access systems (RAS), also 

called bulletin board systems, across the country which run Z- 
System as their operating system. Called Z-Nodes, they 
specialize in supporting Z-System with updates to existing tools, 
developing new tools, distributing useful public domain software, 
and in answering any and all questions dealing with Z-System. 

The main Z-Node, supported by Echelon, is Z-Node Central. The 

number there is C415) 489-9(^05. Located on that board is a list 
of ail the other Z-Nodes so you can find the one closest to you. 

12) Micromint also has a RAS called the Circuit Cellar BBS. 

Designed to support users of Micromint manufactured Circuit 
Cellar projects, it runs on an SB180 and its primary support is 
for the SB180. Call it anytime to obtain advise, ask questions, 
download useful public domain utilities, and read advance 
announcements of other Micromint products. The number is (20 3 ) 
£71-1988. It us^s 8 bits, 1 stop bit, no parity, and runs 300 

an'd~’l200 baud. ~T"t is’*avaiiable 24 hours a day"and, like Z-Node 

Central, makes the list of Z-Nodes across the country available 
to users. 


2 



13) There is an SB180 users' group being lorr.ed and is 
actively recruiting new members. The North American One-Eighty 
Group (N.A.O.G.) publishes monthly newsletters and will be making 
available to members disks full of useful utilities, programs, 
and hints for the cost of the media and shipping. More 
information plus a membership application is available on the 
Circuit Cellar BBS or write or call: 

North American One-Eighty Group 
P.O. Box #2781 
Warminster, PA 18974 
(215) 443-9031 



ERRATA 


f ^ tep z and F igure z . 7-2 

Current proouction boards no longer have jumpers supplied for 
JPlD. Instead JPlh is hardwired for simultaneous 3.b'\ 5.25”, 

and b” operation as shown in the center drawing of Figure 2.7-2. 
This option provides motor control for 5.25" and 3.5” drives, and 
also allows selection between 3.5”/5.25” and b" drives. 

You can reconfigure JP10 if desired by removing the existing 
wire (or, on some boards, cutting the existing trace) and in- 
stalling your own jumpers. 


P 9 e 2_5_, __ F jL ^ u_r e__ j2_. 7-b 

The figure at the bottom of the page is mis-labeled as 
"Figure 2,7-«". It should be labeled as "Figure 2.7-6", 


The figure in the center of the page is mis-labeled as 
"Figure 2.7-8". It should be labeled as "Figure 2.7-7”. 


^ g g _ j 

Addendum: To add an B ” Shugart b50/B6k? DS/DD drive to an 

SB180 with two 5.25"/3.5” drives, the following jumpers should be 
in place: 

850 

2S 

Z 

A 

B 

I 

R 

IV\/ 

S2 

IT 

C 

RS 

HLL 

M 

NF 

DS3 


There should be no terminator on the drive. 
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Copyright Notice 


Copyright (C) 1985 by The Micromint Inc. All rights reserved. 
No part of this publication may be reproduced, transmitted, tran- 
scribed, stored in any form or by any means, manual or otherwise, 
without the prior written permission of The Micromint Inc., 25 
Terrace Drive, Vernon, CT, 06066. 


Disclaimer 


The Micromint Inc. makes no representations or warranties with 
respect to the contents hereof. Further, changes are periodical- 
ly made to the information contained herein. The Micromint Inc. 
reserves the right to incorporate these changes in new editions 
of this publication without obligation to notify any person of 
such revisions or changes. Mention in this document of specific 
product (s) compatible with the SB180 does not constitute an en- 
dorsement of the product (s); rather the information regarding 
specific product(s) is given for illustrative purposes. 


Trademarks 


CP/M, CP/M-80 and MP/M are registered trademarks of Digital 
Research, Inc. MS-DOS is a registered trademark of Microsoft, 
Inc. Z80 is a registered trademark of Zilog, Inc. IBM, IBM PC, 
and IBM Personal Computer are trademarks of the International 
Business Machines Corporation. Z-System is a registered trade- 
mark of Eschelon, Inc. ZCPR is a copyright of R.L. Conn. SB180 
and COMM180 are copyrights of The Micromint, Inc. 


Date of this release: July, 1985 



********************************* 

WARRANTY 

The Micromint, Inc. extends the following warranty: 

A factory manufactured circuit board or assembly caries with 
it a one year warranty covering both parts and labor. Any unit 
which is found to have a defect in materials or workmanship will 
be repaired or replaced at the option of The Micromint, Inc. 

No credit will be given for units which show damage due to 
user modification or neglect. 

Units returned for repair must have prior authorization from 
The Micromint, Inc. A return authorization number may be obtain- 
ed by phone or letter. Please retain a record of the the return 
authorization number as most subsequent correspondence will refer 
to that number. Under no circumstances is any product to be re- 
turned to The Micromint, Inc. without prior authorization. The 
Micromint, Inc. will assume no responsibility for unauthorized 
returns . 

All returns must be shipped prepaid. Insurance is recommend- 
ed as losses by a shipping carrier are not the responsibility of 
The Micromint, Inc. Repaired units will be rturned with postage 
paid . 


For repair of units which have expired their warranty, a 
minimum inspection fee must be prepaid. Contact The Micromint, 
Inc. for information on current minimum charges. 

NO WARRANTY is extended on USER ASSEMBLED systems or kits. 
However, assembled kits will be inspected and repaired with 
charges based on the current minimum one hour charge. However, 
in the event that repair charges would exceed a reasonable 
amount, the user may be consulted for a determination. The 
Micromint, Inc. retains the right to refuse to repair any USER 
ASSEMBLED item. This right is at the sole discretion of The 
Micromint, Inc. 

Repairs on USER ASSEMBLED items must be prepaid. 

Return authorization must be obtained prior to any return. 

The Micromint, Inc. reserves the right to change any feature 
or specification at any time. 
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1.0 


SB180 System Overview 


The Micromint SB180 is a single board computer featuring a 
new generation 8-bit microprocessor which maintains software com- 
patibility with the Zilog Z80 while incorporating advanced design 
features in a single 64 pin chip. The SB180 uses just 29 chips 
on a 4" by 7 1/2" printed circuit board to provide a powerful, 
low cost processing system which is well suited for a wide range 
of appliations - from dedicated process control computers to 
personal computer systems. Figure 1.0-1 shows the functional 
organization of the SB180; 

central processing unit 

memory interface 

RS-232 interface 

Centronics parallel interface 

floppy disk interface 

XBUS expansion bus 

power supply 


The SB180 has the following features; 

* Hitachi HD64180 microprocessor running at 6.1 MHz. 

Supports a superset of the Z80 instruction set. 

* 256K bytes on board RAM memory (can be partitioned as 64K 
byte system memory and 192K byte RAM disk or as paged 
system memory) . 

* Full 8K byte ROM monitor with disk support (format, read, 
write, copy, and boot) . Can support up to 32K byte ROM on 
board . 

* 2 RS-232 serial ports, one with auto-baud rate detect. 

* 1 Centronics parallel printer port. 

* Single/double density programmable floppy disk controller, 
capable of handling a mix of up to four 3 1/2", 5 1/4", 

or 8" drives. Different size drives can run concurrently. 

* Supports 4 external and 8 internal interrupts. 

* Requires 3ust +5 V (and +12 V only for RS-232 operation) . 

* Has an I/O expansion interface 


The SBl80's ROM monitor is designed to use the (optional) 
Echelon Inc. Z-System disk operating system, an enhanced, com- 
patible superset of Digital Research's CP/M 2.2 operating system. 
However, the SB180 can also use the CP/M 2.2, CP/M Plus, MP/M II, 
TurboDOS, or Oasis operating systems (if properly customized). 

The SB180 is a virtually complete system on a single 
board. You need only add a power supply, a serial terminal, and 
one floppy disk drive (40 track or 80 track DS/DD) to form a 
complete functional system. To operate the system, simply turn 
on the power, insert a Z-System disk, and start the bootstrap 
operation. 

Section 2 of this manual provides complete installation 
instructions, and Section 3 gives a complete description of the 
hardware logic components which comprise the SB180 board. The 
ROM monitor is described in Section 4. 
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1.1 


Notational Conventions 


Active low logic signals (those which are true when at a 
logic low level of 0 volts) are indicated in this manual in two 
ways. First, active low signals are denoted by the presence of a 
character following the signal name (e.g., SYSMEMRD*) . These 
signals are also shown with a bar over the signal name, particu- 
larly on the logic diagrams. Both notations mean exactly the 
same thing. On the other hand, active high logic signals (those 
which are true when at a logic high level of 2.4 volts) are in- 
dicated by just the signal name (e.g., READY). 


CONSOLE SERIAL 
PORT 
RS-232C 


auxiliary 

serial 

PORT RS-232C 


XTAL 



3 1/2 ia + 5 1/4 in, 8 in. 

DRIVES DRIVES 


CENTRONICS 

printer 


Figure 1.0-1 SB180 Functional Organization 







2.0 


SB180 Installation Instructions 


The intent of this section is to be a guide to the in- 
stallation of an SB180 system. Section 2.1 provides an overview 
of the installation process and should be read prior to the act- 
ual installation. Information presented in sub-sections 2.1 
through 2.11 should be used to initially install the SB180 system 
including associated peripheral I/O devices. Section 2.4 pro- 
vides a guide to follow when power is first applied if no disk 
drives are connected to the SB180 board and just the ROM monitor 
is being used. Section 2.11 assumes that a 40 track DS/DD 5.25" 
disk drive is connected to the SB180 and that you have the Z- 
System boot disk. 


2.1 Installation Overview 

The SB180 is designed to be relatively simple to set up 
and operate. A "bare bones" SB180 system consists of the fol- 
lowing hardware components: 

* SB180 system board with 256K RAM and 8K ROM monitor 

* RS-232C compatible CRT terminal 

* Power supply 

A more complete system (and a more typical one) would add: 

* one or more 5.25" 40 track (or 80 track) DS/DD 
floppy disk drives (or equivalent 3.5" drives) 

(Note: the SB180 monitor must have a 40 track double 
sided drive for Z-System boot up.) 

* Centronics compatible parallel printer 

Of course once the SB180 is operating in its minimum mode with at 
least one disk drive, other drives may be added. Additional in- 
formation in Section 2.7 will detail the addition of 3.5" and/or 
double sided 8" drives. 

It is suggested that the SB180 be initially installed and 
tested for proper operation without a disk drive. Once the oper- 
ation of the ROM monitor has been verified, a floppy disk drive 
may be added to boot the operating system. 

Although the SB180 has been designed to be compatible with 
"industry standard" peripheral interfaces, it is the responsibil- 
ity of the user to ensure that any peripheral devices purchased 
separately meet the SB180 interface specifications. These are 
defined in the appropriate installation sections and by the act- 
ual peripheral devices themselves. Of particular importance, the 
interconnecting cables must match the interface at both ends. 
Improper cables will be the cause of system malfunctions in al- 
most every instance, so the time spent in verifying the cable 
connections will be well worthwhile. The basic interface con- 
nectors of the SB180 were designed to use flat ribbon cable and 
insulation displacement connectors to simplify cable preparation. 
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The information contained in each of the installation 
sections in this manual is geared towards the novice computer 
user. It is strongly suggested that all users, including those 
experienced in the installation of computer systems, should read 
the installation procedures completely before applying power to 
an SB180 system. Failure to follow the recommended procedures 
may potentially result in damage to components on both the system 
board and/or the peripheral devices. In particular, reversal of 
the +5v and +12v power leads to the power connector results in 
permanent damage to all but one IC on the system board 1 Figure 
2.1-1 shows the silkscreen legend which appears on the SB180 
system board. This picture should be referred to for all of the 
installation procedures as an aid in locating specified connect- 
ors, jumpers, IC sockets, etc. Figure 2.1-2 contains part num- 
bers for recommended mating connectors for those on the SB180 
system board. Connectors for the peripheral ends of intercon- 
necting cables are dependent on each particular peripheral, and 
are specified in the manuals which should have come with them. A 
block diagram of a typical SB180 system using 5.25" floppies, a 
3.5" floppy, and an 8" floppy is shown in figure 2.1-4 

**************************************************************** 

* * 

* CAUTION - DO NOT apply power to the SB180 system until the * 

* Installation Checklist (Section 2.10) has been * 

* completed and you are instructed to do so ! ! ! * 

* * 

**************************************************************** 


Page 5 




SB180 MATING CONNECTOR 


CONNECTOR 

DESCRIPTION 

PART NO. 

QTY. 

MFG. 

J1 

Ext reset 

2 pin solder Hard wire norm, 
pads open pushbutton 

- 

- 

J2-J4 

Ser/Par 

20 pin IDC flat 
cable connector 

609-2000M 

3 

T&B ANSLEY 

J5 

Expan. 

40 pin header 
receptacle 

929975-01-20 

1 

APTRONICS 

J6 

Expan. 

8 pin header 
receptacle 

929974-01-04 

1 

APTRONICS 

J7 

4 pin right 

22-01-2041 

1 

MOLEX 

Power 

angle pin header 

08-50-0114 

4 


J8 

8" drive 

50 pin IDC flat 
cable connector 

609-5000M 

1 

T&B ANSLEY 

J9 

3/5" drive 

34 pin IDC flat 
cable connector 

609-3400M 

1 

T&B ANSLEY 


Figure 2.1-2 RECOMMENDED MATING CONNECTORS FOR THE 

SB180 SYSTEM BOARD 


MODEM 



Figure 2.1-3 Orientation of 20-Pin Headers 
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J3 TERMINAL 
INTERFACE 


J4 MODEM 
INTERFACE 


/\ A 

II II 

II II 

\/ V 


SYSTEM RAM 

1 

1 

1 

1 

HD 64180 

1 

1 

1 

1 

SYSTEM ROM 

41256 (4164) 

1 

1 

1 

1 

1 

1 

CPU 

1 

1 

1 

1 

1 

1 

2764 (27128/27256) 


/\ 
I I 
I I 
\/ 

/ 

/ 

\ 

\ 


/\ 
I I 
I I 
\/ 


LOCAL 



BUS 


/\ 

/\ 

/\ 

1 1 

1 1 

1 1 

1 1 

1 1 

1 1 

\/ 

\/ 

\/ 


1 

J6 BUS 1 

1 

1 

1 

J2 PRINTER 

1 

1 

1 

1 

FDC 9266 

1 

EXPANSION 1 

1 

1 

1 

1. 

INTERFACE 

1 

1 

.1 

1 

1 

1. 

INTERFACE 


\ 

■ \ 
/ 

■/ 


/\ 
I I 
I I 
\/ 


/ \ 

/ \ 

< LIMITED LOCAL BUS > 

\ / 


\ 


/ 


/\ 
I 1 
I I 
\/ 

J9 3 1/2" or 5 1/4" 
DISK INTERFACE 


/\ 

I I 
I I 
\/ 

J8 8" DISK 
INTERFACE 


Figure 2.1-4 SB180 Block Diagram 
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2.2 


Connecting the Power Supply 


The information presented in this section is somewhat 
generalized since the actual installation of the power supply 
will be dependent upon several factors such as the number and 
type of disk drives, and the number of, and the power require- 
ments of any expansion cards which will be installed. An example 
is given of a typical installation which uses a single power sup- 
ply (available from Micromint) to power the SB180 system board 
and two 5.25" floppy disk drives. Recommended part numbers for 
mating power connectors are given in figure 2.1-2 for the SB180 
and in figure 2.7-6 for typical flexible disk drives. 


STEP 1 VERIFY THE POWER SUPPLY RATING 

Before connecting a power supply to an SB180 system, ver- 
ify that the supply is capable of providing enough current for 
all the devices which it will power. This is extremely import- 
ant, since the SB180 system will probably not function correctly 
if the supply is operating at reduced output voltage due to over- 
load. At a minimum, the power supply must be able to supply 
enough current for the SB180 system board. Figure 2.2-1 gives 
the power requirements for the system board. In addition, if the 
main power supply is to be used to power any floppy disk drives, 
then it must be large enough to handle the disk drives as well as 
the system board. Thus, the first step prior to connecting the 
power supply is to total up the current requirements for all of 
the loads. If the total current requirements exceed the rating 
of the power supply, it will be necessary to replace it with 
another one that is capable of handling the required load. 


SUPPLY TYPICAL OPERATING 

VOLTAGE CURRENT 


ALLOWABLE VOLTAGE 
RANGE 


+ 5 VDC 

+ 12 VDC 


0.500 amperes 
0.040 amperes 


+4.75 to +5.25 
+11.4 to +12.6 


Figure 2.2-1 SB180 SYSTEM BOARD POWER REQUIREMENTS 


STEP 2 GET/MAKE UP A POWER CABLE 

The power supply cable attaches to the SB180 system board 
at the 4 pin connector, J7. Part numbers for components of a 
recommended mating connector are given in figure 2.1-2. Signal 
specifications for the power pins are listed in figure 2.2-2 
along with a suggested color coding scheme which will be helpful 
in avoiding the connection of a wire to an improper voltage 
level. WARNING! IF THE POWER CABLE IS CONNECTED BACKWARDS, IT 
WILL DESTROY ALL SYSTEM BOARD COMPONENTS! Figure 2.2-3 illus- 
trates J7 from a side view with each pin identified with its 
corresponding voltage level. 
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PIN NO. 

SIGNAL NAME 

COLOR 

NOTES 

1 

+12 V 

YELLOW 

40 ma power 

2 

+12 V RETURN 

BLACK 

ground 

3 

+ 5 V RETURN 

BLACK 

ground 

4 

+ 5 V 

ORANGE 

500 ma power 


Notes; 1. All wires should be 24 AWG minimum 

2. RETURN is the same as GROUND 

3. BLACK can be used for both GROUNDS 

4. Cable is available as Micromint P/N SB180-P 


Figure 2.2-2 J7 POWER SIGNAL SPECIFICATIONS 



Figure 2.2-3 Side View of Power Connector J7 
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The type of connector, if any, which attaches at the power 
supply end of the cable depends upon the particular power supply 
to be installed. In general, each manufacturer tends to use a 
different connector, and in most instances a mating connector is 
not included with the power suply itself. If a mating connector 
cannot be acquired, the wires can usually be soldered directly to 
the connector pins, although this is not a recommended practice. 
In addition, some power supplies use screw type connectors which 
attach to automotive style spade lugs. These spade lugs would be 
soldered or crimped to the power leads, and can be used to form a 
good, reliable power connection which can be easily disconnected 
if necessary. 

If your power supply will operate with no load (some 
switching supplies require a minimum load) , this would be a good 
point to verify its proper operation. Checking voltages at the 
connector for the system board insures proper pin outs. 

is ^ieifickieidcieicieicicieicicicik’kicicicicicicicidcicicic-kicicicickiticicicicicieicicikicickickicicicitic'kicicik'kicic 
* * 

* CAUTIONS UNPLUG ALL AC POWER CORDS BEFORE PROCEEDING * 

* * 

***************************************************************** 


STEP 3 ATTACH THE POWER CABLE 

Refer to figures 2.1-1 and 2.2-3 for the location and 
orientation and attach the 4-pin connector to J7 being sure to 
orient pin number 1 correctly. Make sure that all the pins in 
the connector and J7 are aligned properly before making the 
connection. Next, attach the opposite end of the cable to the 
power supply. Be sure that the correct wires are hooked up to 
the proper voltages. If a color coding scheme such as the one 
suggested was followed, this should not be a problem. 


•k ic ic ic ic -k is :k ie ic ic ic ie is -k ic is ic ie if ic icie ie is ie ie is "k ic icicie icici^ i( ic ic ie i( ic ic if ic icic is ic ic it ie icic is i( ic -k ic ie i(ic 
k k 

* CAUTION - MAKE SURE THAT THIS CONNECTOR IS INSTALLED IN THE * 

* CORRECT ORIENTATION TO PREVENT DAMAGE TO THE * 

* SYSTEM BOARD. * 

* * 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


This completes the SB180 system board power supply in- 
stallation. Note: DO NOT plug in the AC power cord to a line 
outlet at this time. 
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2.3 


Connecting the Main Console I/O Device 


The main console I/O port on the SB180 is designed to 
attach directly to a standard RS-232C compatible CRT data term- 
inal, such as a Televideo 950. The console serial device is 
attached to the SB180 system board at the 20-pin, dual row head- 
er, J3, which mates with standard 20-pin female flat cable con- 
nectors, such as the one recommended in figure 2.1-2. Signal pin 
assignments for J3 are listed in figure 2.3-1. The connector at 
the terminal end of the cable is typically a 25-pin DB-25 "D" 
style connector, and can be either a male or a female connector 
depending upon the requirements of the particular serial I/O de- 
vice that is being used for the console. 

The SB180 board as shipped is configured such that the 
console I/O port operates as Data Communications Equipment (DCE) . 
In most instances where CRT (video display) data terminals are 
used, the serial device is set up to operate as Data Terminal 
Equipment (DTE), and no special configuration is needed. In this 
case, the pins on J3 tie directly to corresponding pins on the 
connector of the serial device. On the other hand, if the serial 
device is also operating as DCE, then the signal pins must be 
swapped in the cable assembly (reverse pin 2 with 3 at one end) . 


PIN# EIA RS-232C SIGNAL NAME I/O (DTE) I/O (DCE) 


2 

3 

7 


1,4-6,8-20 


TRANSMITTED DATA (TXD) 
RECEIVED DATA (RXD) 
SIGNAL GROUND (GND) 

NOT USED 


0 

I 


I 

0 


Notes: 1. Signal direction at J3 is for DCE operation. 

2. If hardware handshake is required for the console, 

J3 may be configured to provide an interface gate for 
pin 5 (CTS) by changing jumpers JP4 and JP5. 

3. The console cable is available as Micromint P/N SB180-T 


Figure 2.3-1 J3 SERIAL INTERFACE SIGNAL ASSIGNMENTS 
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In addition to the problem of matching the cable at each 
end to the correct interface signals, both the data terminal de- 
vice and the SB180 system board must be set up to operate with 
the same set of parameters, such as number of data bits, number 
of stop bits, type of parity bit, baud rate, etc. This is ac- 
complished via DIP switch settings on the terminal, though some 
older terminals may use hard-wired jumpers. The SB180 features 
auto baud rate detect for 300, 1200, 9600, and 19,200 baud, so 
the terminal may be set for any of these baud rates. The default 
values for the SB180 are: 8 data bits, 1 stop bit, and no parity. 
This code configuration may be changed after the SB180 is 
operating but must be adhered to for initial operation. Keeping 
these things in mind, you are now ready to configure and install 
the main communications device. 


STEP 1 TURN OFF POWER 

Disconnect power to both the SB180 system board and to the 
serial device which is being installed as the main console de- 
vice. Removing power is best accomplished by unplugging all AC 
power cords. 


STEP 2 CONFIGURE THE MAIN CONSOLE DEVICE 

The first step is to read the installation instructions 
which should be included in the manual for the CRT data terminal 
(or other serial device if applicable) . Follow the instructions 
given and set up the data terminal for operation with these 
parameters: 

8 data bits 
1 stop bit 
no parity 

baud rate; 300, 1200, 9600, or 19,200 

If the serial device is configurable for either DCE or DTE opera- 
tion, set it up as DTE according to the instructions given in the 
manual for the device. Most CRT terminals are already configured 
for DTE operation. 


STEP 3 GET/MAKE UP THE CONSOLE CABLE 

If a cable was not purchased with the SB180 system board, 
one must be constructed. The connector which mates with the J3 
header should be a 20 pin (2x10) female flat cable connector on 
.100" centers. Refer to figures 2.1-1 and 2.1-4 for the location 
of J3 and the position of pin number 1. The connector which in- 
terfaces with the serial device will be specified in the manual 
for the device, but it is usually a 25-pin "D" connector. The 
actual construction of the cable depends on both the type of 
connectors and cable being used. The entire flat cable might be 
crimped at one time or individual pins may need to be crimped or 
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soldered, and then inserted into a connector shell. Most serial 
terminals conform to the RS-232 DTE standards (i.e., they trans- 
mit data on pin 2 and receive on pin 3) . The SB180 mates as a 
DCE device (receives data on pin 2 and transmits on pin 3) . If 
the serial device is not operating as DTE equipment as previously 
mentioned, reverse pin 2 with pin 3 on one end of the cable. 


STEP 4 ATTACH THE CONSOLE CABLE 

Refer to figures 2.1-1 and 2.1-4 and connect the RS-232C 
cable at the SB180 system board, J3, which is a 20 pin dual row 
header. Be sure that pin number 1 of the cable is oriented 
correctly with pin number 1 of J3. Now attach the cable to the 
serial device. If the connector is one of the the D style con- 
nectors, it will only go on one way. If not, use the information 
given in the manual for the device to verify that the connector 
is properly installed. 


This completes the installation of the console device. 


2.4 Turning On Power 

This section describes the procedure for turning on power 
to the SB180 system for the first time. The SB180 board, if pur- 
chased fully assembled, has been "burned in" and fully tested 
prior to shipment. If any problems occur during the initial 
power up procedure and operational tests, the source of the 
problem will almost always be due to either an improper cable 
connection to the terminal or an incorrect option configuration 
on the terminal. 

The information presented is intended to aid those users 
who have purchased a fully assembled and tested version of the 
SB180 system board. Due to the complexity of the circuitry on 
the board and the sophistication of some of the IC's, problems 
which are caused by errors in construction might require a full 
trouble-shooting effort with some sophisticated test equipment. 
Difficulties on this scale are beyond the scope of the text 
presented here. However Micromint does offer an inspection and 
repair service if needed. 


STEP 1 SET UP THE POWER SYSTEM 

The ideal arangement of the power system will have all AC 
power outlets associated with the SB180 system controlled by a 
single ON/OFF switch or circuit breaker. If this is the case, 
first turn off the main switch, and then turn on the power 
switches to the system power supply and the main console I/O 
device. Now the main switch can be used to turn the SB180 system 
on and off. Otherwise the individual components will have to be 
controlled independently of one another. This discussion assumes 
that this is the case. 
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Position the ON/OFF switch on the power supply and on the 
main console I/O device to the OFF position. Unplug any power 
supply or device which does not have an ON/OFF switch. Plug the 
AC power cords of all devices which are switched (e.g., have an 
ON/OFF switch) into a wall outlet. Do NOT apply power to the 
system at this time. 


STEP 2 LAST MINUTE CHECKS! 

Recheck all cable connections to the SB180 system board 
and to the main console i/0 device. This includes both I/O in- 
terface connections, and power cable connections. Make sure that 
all connectors are installed correctly and are fully mated. 

It would be a good idea at this time to verify that all 
IC's on the system board are fully inserted in their sockets and 
are oriented in the proper direction. Sometimes during shipping 
or during rough handling, ICs may work themselves loose in their 
sockets. Use your finger to press them all the way down in the 
socket. If you position the SB180 system board so that the label 
"SB180" is on the bottom edge of the board facing you, the power 
supply connector will be at the top left side of the board. With 
the board in this orientation, most of the ICs are oriented vert- 
ically with pin 1 being at the bottom right. The remaining ICs 
are oriented with pin 1 to the bottom left. The top of the IC is 
usually indicated either by a notch or by a small circular dot on 
the IC. 


STEP 3 READY TO APPLY POWER! 

Now you are ready to apply power to the system. This step 
is sometimes referred to as "smoke testing" the system, since 
components have been known to burn up due to improper install- 
ations. If any smoke is observed during this step, turn off 
power immediately and investigate the cause before proceeding. 
Possibilities here include incorrect cable connections, and ICs 
which are installed upside down in their sockets. 

If you are at all unsure of the power supply connections, 
now is the time to check them for the proper voltages as listed 
in figure 2.2-2. First, read section 2.12, "Troubleshooting". 
Disconnect the power supply cable from J7, apply AC power to the 
system power supply only, and use a multimeter to ensure that the 
voltages are correct. If the voltages are correct, remove power 
to the power supply and reconnect the power supply cable to J7 on 
the SB180 system board. 

It is assumed that a video display terminal has been in- 
stalled in the system as the console I/O device. When power is 
first applied to the SB180 system, what is first seen on the main 
console I/O device depends upon a number of factors such as the 
type of terminal and baud rate. You may see a completely blank 
screen with a cursor in the upper left corner, or you may see a 
few random characters or letters on the screen. 
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Turn on power to the console I/O device first and then to 
the SB180. Normal responses will be; 

1) A cursor should appear on the screen in 4 to 5 seconds. 

2) As mentioned above, you may see one or more random 
characters on the terminal screen. 

3) Press the RETURN or ENTER key on the terminal keyboard. 
This tells the SB180 the baud rate at which the terminal 
is operating. 

4) On the screen will appear the message "Micromint ROM 
Monitor Version xx.xx" 

These responses indicate that the SB180 system board has success- 
fully completed initialization, recognized that no disk drives 
were attached to it, waited until a key was pressed on the term- 
inal, analyzed it to determine the baud rate, set the baud rate, 
and then turned control over to the ROM monitor. If the system 
responded correctly as indicated above, go on to the next step. 
Otherwise, first try pushing the reset button, PBl, on the system 
board. If there is still no response, turn off power to the 
system, wait a few seconds, and try again. If the system still 
does not respond, go to the "IN CASE OF DIFFICULTY" section. 


STEP 4 TESTING THE ROM MONITOR 

The SB180 system should now be waiting for you to enter a 
command. The monitor prompt is "0>" where "0" denotes the fact 
that you are currently using the first 64K bank of memory. If 
you enter a "?", you will see displayed a full page "help" screen 
showing all of the monitor commands. Since a disk drive is not 
connected at this time, some of the commands will return an error 
status code when used. Using the information in Section 4.6 as a 
guide, you can try these commands: 

A,B,D,F,H,M,Q,S,T,V,X, and Y 

In particular, the "T" command (without additional parameters) 
performs a continuous memory test until terminated by a Control-C 
or Control-X. The SB180 could test memory until you are ready to 
attach disk drives, a parallel line printer, and an auxiliary 
serial device such as a modem, as detailed in the next section of 
this manual. 


2.5 Connecting an Auxiliary Serial I/O Device 

The auxiliary I/O port is very useful in adding an extern- 
al modem or serial printer to the SB180 system. Most modems 
usually operate as Data Communications Equipment, and J4 is set 
up as Data Terminal Equipment, so a standard pin-to-pin cable 
assembly should work fine. If you do not own an external modem. 
Micromint has an expansion board {COMM180) for the SB180 which 
contains a 300/1200 baud modem connected directly to the system 
data bus, thus it does not use the auxiliary I/O port on the 
system board. 
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Installing an auxiliary serial I/O device requires the 
same steps as the installation of the console serial device. The 
differences are that the interface connector is located in a 
different spot, has a different number, and that the pin numbers 
are oriented 180 degrees from the console serial interface con- 
nector. As such, refer to the information given in section 2.3 
for installing the main console serial I/O device and follow 
those same procedures to install an auxiliary device. Substi- 
tute J4 in place of J3 where ever it occurs. Figure 2.1-1 shows 
the location of J4. As you can see J3 and J4 are situated ad- 
jacently on the SB180 system board. If you have already install- 
ed the console device this step should be straight-forward. It 
is recommended that the entire procedure given in section 2.3 be 
read in its entirety prior to actually installing the auxiliary 
serial I/O device. 


2.6 Connecting a Parallel Printer 

The SB180 system board supports a standard Centronics com- 
patible parallel printer interface. The printer interface cable 
attaches to the SB180 system board at the 20-pin dual row header, 
J2. Refer to figures 2.1-1 and 2.1-4 for the location and orien- 
tation of J2. Figure 2.1-2 gives a part number for a mating con- 
nector. The connector at the printer end of the cable varies be- 
tween different printers. A typical connector which is compat- 
ible with Centronics style printers is a 36-pin male Amphenol 
part number 57-40360. This connector is also designed to use 
flat ribbon cable with pin 1 connecting to pin 1 on J2; unused or 
open pins on the Centronics connector fall toward the pin 36 end 
of the connector. Many of the newer printers tend to use the 25- 
pin "D” style connectors similar to the ones used by the serial 
I/O devices. Figure 2.6-1 below lists the signal specifications 
for J2. 


J2 SIGNAL NAME 

PIN NO. 


CENTRONICS I/O 

PIN NO. 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11-20 


DATA STROBE* 1 

DATAl 2 

DATA 2 3 

DATA 3 4 

DATA4 5 

DATA5 6 

DATA 6 7 

DATA 7 8 

DATA 8 9 

ACKNOWLEDGE* 10 

SIGNAL RETURNS 19-30 


0 

0 

0 

0 

0 

0 

0 

0 

0 

I 


Note: This cable available as Micromint P/N SB180-PR 


Figure 2.6-1 J2 PRINTER SIGNAL INTERFACE SPECIFICATIONS 
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STEP 1 


DISCONNECT POWER 


Check to make sure that power is not applied to either the 
SB180 system board, or to the printer device. Power should be 
removed by unplugging all AC power cords associated with the SB- 
180 system, including those of all peripheral devices. 


STEP 2 VERIFY PRINTER INTERFACE SIGNALS 

First, read the manual which came with the printer, par- 
ticularly the section which discusses the installation of the 
printer in a computer system. Next, verify that the signals on 
each pin are the same as the signals available at J2 on the SB180 
system board. Write down those which are on a different pin so 
that a printer cable can be constructed in a later step. In most 
cases the only signals needed are the data lines, the data 
strobe, the data acknowledge, and a signal return path (ground). 


STEP 3 CONFIGURE THE PRINTER 

Follow the instructions in the installation section of the 
printer manual, and set it up for operation as desired. Choices 
here may include options such as page size, type style, page mar- 
gins, automatic line feed, character set, etc. (The SB180 mon- 
itor normally sends a line feed after each carriage reurn.) Also, 
if the printer can be configured for the polarity of the strobe 
and acknowledge signals, make them both active low. The polarity 
of the printer interface control signals can also be changed by 
writing a software routine if necessary. Source code for the ROM 
monitor is available on disk. 


STEP 4 GET/MAKE UP A PRINTER INTERFACE CABLE 

If a printer interface cable was not purchased with the 
SB180 system board, one must be constructed. If one is avail- 
able, use the signal specifications listed in figure 2.6-1 and 
information from the printer manual to verify the wiring. Change 
any wires which are incorrect. You should have a list of these 
from Step 2 above. If a new cable must be constructed from 
scratch, first verify that the two connectors mate properly with 
both the 20 pin header at J2 and at the printer's interface con- 
nector. Next, wire the two connectors together such that each 
signal connects to the proper pin number at both ends of the 
cable. The J2 header pin layout mates directly with insulation 
displacement connectors and flat ribbon cable. 


STEP 4 SELF-TEST THE PRINTER 

Many printers have a self-test function which continuously 
prints all the printable characters in a line across the paper. 
If the printer has this capability, follow the instructions in 
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the printer manual and run the self-test. Be sure to turn off 
power to the printer and to disconnect the AC line cord before 
proceeding . 


STEP 5 ATTACH THE CABLE 

Attach the cable to the appropriate connectors at each 
end. Be sure to align pin 1 on J2 correctly (see figures 2.1-1 
and 2.1-4). If the printer connector is a "D” style connector, 
it will only go on one way. If it is not, refer to the printer 
manual for the proper orientation of the mating connector. 

This completes the installation procedure for the parallel 
printer device. 


2.7 Connecting Eloppy-Disk Drives. 

The SB180 system board has been designed to interface to 
the standard 5.25 inch flexible (usually called minifloppy) disk 
drive, to the 8 inch floppy disk drive, and to the newer 3.5 inch 
microfloppy disk drive. (Note: there are several different types 
of 3.5 inch floppy drives. The SB180 can use only the 40 or 80 
track drive that is pin compatible with the 5.25 inch miniflop- 
py.) A thirty-four pin flat cable connecter is installed on the 
system board to allow for up to four drives of either 5.25 inch 
and/or 3.5 inch type to be attached in a daisy-chained fashion at 
a time. Space is provided for the fifty pin flat cable connector 
needed for 8 inch double sided disk drives, but it is not in- 
stalled since most users will not be using this size drive. This 
connector is available from Micromint (P/N SB180-8X) . Although 
instructions are given for using 8 inch drives, the Z-System disk 
operating system is delivered only on 5.25 inch diskettes and a 
5.25 inch double sided drive (40 track) MUST be connected to the 
SB180 initially to start up. Any 3.5 inch drives are considered 
equivalent to 5.25 inch drives and may be daisy chained along 
with them. Eight inch drives (double sided only) may be added 
simultaneously or later (but you must add the 8 inch connector 
(J8) as mentioned above) . 

The interface connectors for both types of drives support 
the "industry standard" interface specifications for floppy disk 
drives, and thus can attach directly to many of the standard 8 
inch and minifloppy drives currently being used. It is the re- 
sponsibility of the user to ensure that the particular drive to 
be installed adheres to the interface specifications of the SB180 
flexible-disk controller interface. In addition, there are sev- 
eral jumpers on the system board which may be installed or re- 
moved depending on the size of the disk drives used. Figure 2.1- 
1 shows the location and orientation of connectors and jumpers 
associated with the floppy-disk interface. Refer to it as 
required during the installation procedures. 
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The installation of floppy-disk drives to an SB180 system 
can be complex. If at all possible, an OEM manual for the drives 
which are being installed should be obtained. Since manuals are 
not always readily available, the discussions which follow detail 
the installation of the Teac 55B 5.25 inch and Shugart SA850 8 
inch disk drives as examples. The 3.5 inch drive is for this 
purpose the equivalent of a 5.25 inch drive. (Some manufacturers 
of 3.5 inch drives use a 34 pin header rather than the standard 
edge connector, but the pin assignments are identical.) 

Figure 2.7-1 lists the jumpers associated with the floppy- 
disk drive interface section of the SB180 system board which are 
dependent on the drive size, 5.25 inch (or equivalent 3.5 inch) 
or 8 inch. The installation descriptions given are generalized 
for both types of floppy drives, and the user is directed to the 
appropriate figures and tables for each type of drive as needed. 

In the following discussion, references to signals at the 
SB180 system board interface refer to disk drives as number 0, 1, 
2 or 3. The Z-System DOS, however, refers to these drives as A, 
B, C and D, respectively. Sometimes disk drive manuals refer to 
the different drive selection options as drives 1, 2, 3 and 4. 


JUMPER PURPOSE 


JPG Required for drives without READY line. Generally 
older drives do not provide this line. 

JP7 Hard wired on back of board for fixed write pre- 
compensation. Cut on circuit side and install a wire 
jumper for controlled pre-compensation. Controlled 
pre-comp is applied only on inner tracks while fixed 
pre-comp is applied during write operations on all 
tracks. 8" drives may require write pre-compensation. 

JP8 Hard wired on back of board for NO write pre-comp. 

See SMC 9266 manual for full specifications. 

JP9 Allows use of only single sided drives; in mixed sys- 
tems, a single sided drive would have a jumper in- 
stalled to enable use of this multiplexed status line. 
Z-System software does not support one side operation 

JP10 For mixed drive size operation. Allows the processor 
TXS line to control 5.25" drive motors or selection 
of 5.25"/8" data transfer rates to disk controller. 

Note: These jumpers are intended to implement all of the 

advanced features of the disk controller and for special 
configurations. No changes required for most standard drives. 

Figure 2.7-1 JUMPER SELECTION FOR DISK DRIVES. 
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Frctn one to four soft-sectored floppy-disk drives can be 
attached to one of the two SB180 system board flexible-disk 
interface connectors. J9, a 34-pin right angle flat cable 
connector, is used to attach 5.25 inch minifloppies (and 3.5 inch 
microfloppies). J8, a 50-pin cable connector (optionally in- 
stalled by the user) , is used to attach standard 8 inch floppy 
disk drives. Both connectors mate with standard flat cable con- 
nectors such as the ones recommended in figure 2.1-2. Interface 
signal definitions are shown below in figures 2.7-2 and 2.7-3 for 
5.25 inch and 8 inch drives, respectively. Although the signal 
pin-outs have been designed to directly interface with many of 
the drives commonly in use today, the SB180 system installer must 
verify that all signals match the interface requirements for the 
particular drive which is being installed. In some instances, it 
may be necessary to change some of the wires on the drive inter- 
face cable in order to match up the interface signals between the 
drives and the SB180 system board. If the drives being installed 
are compatible with the Teac 55B minifloppy or the Shugart SA850 
8 inch drive interfaces, there should be no problems associated 
with attaching the drives to the SB180 system board, and getting 
Z-System up and running. 


STEP 1 TURN OFF POWER 

Before doing anything else, ensure that all power is 
turned off to both the SB180 system board and to all of the flop- 
py disk drives. The safest procedure to follow is to unplug all 
AC power cords associated with the SB180 system, including those 
of peripheral devices. 


STEP 2 CONFIGURE FOR 5.25-INCH (AND 8-INCH DISK DRIVES) 

Refer to figure 2.1-1 for a picture of the location of the 
SB180 system board jumpers associated with the flexible-disk 
drive interface. Next, use the table in figure 2.7-1 to select 
the appropriate jumpers for the type of floppy-disk drives which 
are to be installed. A diagram of the flexible-disk interface 
area of the SB180 system board with jumpers installed at JP10 for 
5.25 inch, for 8 inch, and for mixed size drives is given in 
figure 2.7-4. Using the appropriate pictorial view as a refer- 
ence, configure the SB180 system board for the desired drive type 
by installing the jumpers as indicated in the table. Note that 
these jumpers are configured based solely on the size of disk 
drive, and are the same regardless of which manufacturer's drive 
is used. 

Page 20, S tep 2 a nd Figure 2.7 -2 

Current production boards no longer have jumpers supplied 
JP10. Instead JP10 is hardwired for simultaneous 3.5", 5.25 
and B" operation as shown in the center drawing of Figure 2.7 
This option provides motor control for 5.25" and 3.5" drives, 
also allows selection between 3.5"/5.25" and B" drives. 

You can reconfigure JP10 if desired by removing the existing 
wire (or, on some boards, cutting the existing trace) and in- 
stalling your own jumpers. 


for 

f 

-2 . 
and 
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3"/5" Operation 

3”/5"/8” Operation 

8" 

o 

o 
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1 
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o 

1 

o 

o 

o 

Figure 2.7-2 

JP10 Jumper Setup 



Only 


o o 


o 


STEP 3 VERIFY DISK DRIVE INTERFACE SIGNALS 

The next, and perhaps the most important step to take, is 
to verify that all of the signals at the floppy-disk drive match 
those of the SB180 floppy-disk drive interface specifications as 
listed in figure 2.7-2 for 5.25 inch drives, or in figure 2.7-3 
for 8 inch drives. If such is not the case, the disk drive 
interface cable must be altered such that all signal names agree 
at both ends. Also noted are pins which are directly compatible 
with the Teac 55B or Shugart SA850 disk drives. Note that disk 
drives are generally connected with flat ribbon cable. Due to 
the pinouts of the connectors, adjacent signal lines have an 
interposing ground line between them in the cable. Failure to 
provide this grounding virtually guarantees problems! 


PIN NO. SIGNAL NAME 


4 

HEAD LOAD/IN 

USE* 

6 

DRIVE SELECT 

3* 

8 

INDEX* 


10 

DRIVE SELECT 

0* 

12 

DRIVE SELECT 

1* 

14 

DRIVE SELECT 

2* 

16 

MOTOR ON* 


18 

DIRECTION 


20 

STEP* 


22 

WRITE DATA* 


24 

WRITE GATE* 


26 

TRACK 0* 


28 

WRITE PROTECT* 

30 

READ DATA* 


32 

SIDE SELECT 

(0/-1 

34 

READY* 



ALL ODD PINS SIGNAL RETURNS (REQUIRED) 


Note: This cable is available as Micromint P/N SB180-DSK 


Figure 2.7-3 J9 - 5.25” INCH DRIVE INTERFACE SPECIFICATIONS. 
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The head load function should be configured at the disk 
drive end of the interface cable according to instructions given 
in the drive manual. Use of this capability can greatly extend 
the useful life of the flexible diskettes. Not all drives sup- 
port a head load option at the interface. 

It is quite likely that the floppy disk drive does support 
a READY* control function. In case your drive does not support a 
READY* line, jumper JP6 on the SB180 system board must be in- 
stalled for the disk controller to function. Most newer 5.25 
inch drives do support a READY* control function. READY* gener- 
ally indicates that a diskette is installed and seated in the 
drive. On some drives READY* only becomes active when index 
pulses indicate that the disk is up to speed. 


PIN NO. SIGNAL NAME 


2 

4 

6 

8 

10 

12 

14 

16 

18 

20 

22 

24 

26 

28 

30 

32 

34 

36 

38 

40 

42 

44 

46 

48 

50 


LOW CURRENT* 
FAULT RESET* 
FAULT* 

MOTOR ON 2* 
TWO SIDED* 
MOTOR ON 1* 
SIDE SELECT 
MOTOR ON 0* 
HEAD LOAD 0* 
INDEX* 

READY* 

HEAD LOAD 1* 
DRIVE SELECT 
DRIVE SELECT 
DRIVE SELECT 
DRIVE SELECT 
DIRECTION 
STEP* 

WRITE DATA* 
WRITE GATE* 
TRACK 0* 

WRITE PROTECT 
READ DATA* 
HEAD LOAD 2* 
HEAD LOAD 3* 


(not used) 
(not used) 
(not used) 

(not used) 
(0/-1) 

(not used) 


(not used) 
0 * 

1 * 

2 * 

3* 


* 

(not used) 
(not used) 


ALL ODD SIGNAL RETURNS (REQUIRED) 

PINS 


Figure 2.7-4 J8 - 8" DRIVE INTERFACE SPECIFICATIONS 
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STEP 4 


CONFIGURE THE DISK DRIVES 


This step is highly dependent on the particular drive type 
to be installed. As an aid in configuring the disk drives, sec- 
tion 2.7.1 describes a typical configuration for the installation 
of two Teac 55B minifloppy disk drives, and section 2.7.2 dis- 
cusses typical option selections for installing Shugart SA850 
eight inch drives. Note that there are two main differences be- 
tween the two drives in either case: each drive has a different 
drive select control line enabled (thus these are called "radial" 
lines), and only the drive which is physically locateci at the end 
of the interface cable has terminator networks (usually DIP re- 
sistor networks) installed for the "multiplexed" signals (those 
which share a single cable wire) . The SB180 uses a 330 ohm term- 
inator network allowing up to 1.5 meters of total cable length. 
For some of the newer low power (CMOS) drives, this termination 
may require a higher value terminator. Use of a Ik terminator 
reduces allowable cable length to 1 meter. Where longer cables 
are required, a 150 ohm terminator may be installed to allow up 
to 3 meters of cable. If SIP4 (the terminator) must be changed, 
it must be desoldered from the SB180 board. 


STEP 5 CONFIGURE THE SB180 SYSTEM BOARD 

Configuring the SB180 system board for disk drives con- 
sists of setting the appropriate jumpers. If only double sided 
5.25 inch (and 3.5 inch) drives are being used, then no changes 
are required. Note that the operating system software supplied 
initially requires the use of 5.25 inch double sided drives; you 
may then change jumpers, modify the BIOS and monitor EPROM to 
boot from 8 inch drives. No BIOS or EPROM changes are required 
to add 8 inch double sided drives to a system which has 5.25 inch 
drives as well. 

The connectors on the "T"-shaped block JP10 (upper right 
hand corner of the SB180 system board) must be set as shown in 
figure 2.7-4. Finally, if the disk drives do not support a 
multiplexed READY* control signal, then install a shorting jumper 
wire in JPb; this signal must be active before the floppy-disk 
controller will attempt to read a disk. Most 8 inch drives and 
newer 5.25 inch drives tend to support this control signal while 
some older 5.25 inch drives do not. 


STEP 6 GET/MAKE UP DISK DRIVE CABLES 

Floppy-disk drives require both a power cable (in some 
cases two of these are needed) and an interface cable. The typ- 
ical 5.25 inch (or 3.5 inch) minifloppy drive uses a 34-pin dual 
row card edge type of connector for the interface, and a 4-pin 
power connector for +5 and +12 VDC power. The typical 8 inch 
disk drive requires a 50-pin dual row card edge type of connector 
for the interface signals, a 6-pin power cable for DC power, and 
a 3-pin cable for AC power. Figure 2.7-5 lists mating connector 
part numbers for the Teac 55B minifloppy and the Shugart SA850 8 
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inch floppy-disk drives. For other manufacturers' drives consult 
the drive manual to verify mating connector part numbers as well 
as signal specifications. 


CONNECTOR 


3.5 INCH 

5.25 INCH 

8 INCH 

TYPE 

MFC. 

PART # 

PART # 

PART # 

INTERFACE 

ANSLEY- 

3M 

AMP 

609-3400M 

1-499566-9 

609-3415M 

3463-001 

1-499560-2- 

609-5015M 

3415-0001 

1-499566-2 

DC POWER 

AMP 

- 

1-480424-0 

11-480270-0 

AC POWER 

AMP 

N/A 

N/A 

1-480303-0 


Notes: 1. Pins for the AMP housings are AMP number 60619-1 
2. Part numbers given are typical, but may not 
match all drives. Consult the drive manual. 


Figure 2.7-5 DISK DRIVE CONNECTORS SPECIFICATIONS. 


If cables were not purchased with the SB180 system board, 
or are not already available, they will have to be constructed 
for the floppy-disk drives. When making the interface cable be 
sure that all of the signals are the same at the SB180 flexible 
disk interface connector as at the disk drives. The number of 
connectors needed which mate with the disk drives obviously de- 
pends on the number of drives which are being installed. Of 
course, a cable with connectors for all four drives can be made 
up even if all four drives will not be installed at this time. 
This would simplify later expansion of the system for additional 
drives. 


STEP 7 ATTACH THE DISK INTERFACE CABLE 

Attach the 34- or 50-pin flat cable connector, as appro- 
priate, to the SB180 system board connector, J9 or J8, respec- 
tively. Make sure that pin 1 of the cable connector matches up 
with pin 1 of the disk interface connector on the SB180 system 
board. If the SB180 system board is held such that J9 and J8 are 
located at the top of the board, pin number 1 is the upper right 
pin. Now connect the edge card connectors to the floppy disk 
drives. The order in which drive numbers are attached does not 
matter, except that the last drive located at the far end of the 
interface cable must be the one which has the terminators 
installed for the multiplexed signals as previously described. 
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STEP 8 


ATTACH THE DISK DRIVE POWER CABLE (S) 


Depending on the requirements of the particular drive which 
is being installed, one or two power cables may be needed. Attach 
the DC power cables at both ends. These cables are usually con- 
structed so that the wires are daisy-chained from one drive to 
the next. For small SB180 systems, the end of the DC power cable 
which attaches to the power supply may be part of the power con- 
nector for the system board, and may have already been installed 
from section 2.2. Next attach the AC power cable if one is re- 
quired, but do not plug the AC source into a power outlet at this 
time. In most instances the power end of the AC line cord will 
probably tie into a terminal block and a single plug or power 
switch will be used to power the entire SB180 system. 


2.7.1 Installation of Teac 55B 5.25 inch Disk Drives 

This section describes the installation of two Teac 55B 
5.25 inch flexible disk drives. These drives are double-sided, 
and can record in either single- or double-density formats. The 
two drives are set up for multiple drive operation. All inter- 
face signals are TTL compatible with a logic-low of +0.4V maximum 
and a logic-high of +2.4V minimum. A logic-low indicates a 
"true" or active condition, while a logic-high indicates a 
"false" or inactive condition. The maximum length of the inter- 
connecting cable, from the SB180 system board connector, J9, to 
the last drive on the cable is 4.5 feet. The recommended cable 
is standard flat ribbon cable with a characteristic impedance of 
100 ohms, or equivalent twisted pairs. Figure 2.7-6 lists option 
selections on the 55B's in a typical two-drive installation. 


OPTION 

DESIG. 

55B DESCRIPTION 

DRIVE 

A B 

SOCKET 

PINS 

— 

TERMINATOR NETWORK 

R 

I 

(SOCKET J3) 

HS 

HEAD SOLENOID 

R 

R 

1-16 

DS0 

DRIVE SELECT 0 

I 

R 

2-15 

DSl 

DRIVE SELECT 1 

R 

I 

3-14 

HM 

HEAD MOTOR CONTROL 

R 

R 

4-13 

DS2 

DRIVE SELECT 2 

R 

R 

5-12 

DS3 

DRIVE SELECT 3 

R 

R 

6-11 

MX 

MULTIPLEX OPERATION 

R 

R 

7-10 

UR 

LED OPTION 1 (SEL+RDY) 

I 

I 

1-16 

ML 

MOTOR ON 

I 

I 

2-15 

lU 

IN USE 

R 

R 

3-14 

HL 

HEAD LOAD 

R 

R 

4-13 

SM 

HM/HS ENABLE 

R 

R 

5-12 

U0 

LED OPTION 2 (IN USE) 

R 

R 

6-11 

U1 

LED OPTION 3 

R 

R 

7-10 

RE 

RECALIBRATE 

R 

R 

8- 9 


Note: I=installed, R=removed 

Figure a. 7 > 6 - TEAC 55B CONFIGURATION GUIDE 
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2.7.2 Installation of Shugart SA850 8 inch Drives 


This section illustrates the installation of two Shugart 
SA850 8 inch flexible-disk drives. Figure 2.7-7 lists the option 
selections which are typically installed on the disk drives. 
Note that jumper wires must be added at each drive to select the 
head load options since a common signal wire at pin number 18 on 
the interface cable is used for all drives. 


TRACE SA850 DESCRIPTION 

DESIG. 


DRIVE 
0 1 


Tl 

HEAD LOAD TERMINATOR 

I 

I 

T2 

DRIVE SEL. TERMINATOR 

I 

I 

T3-T6 

TERM. FOR MULTIPLEX INP. 

R 

R 

DSl 

DRIVE 1 SELECT INPUT 

I 

R 

DS2 

DRIVE 2 SELECT INPUT 

R 

I 

DS3 

DRIVE 3 SELECT INPUT 

R 

R 

DS4 

DRIVE 4 SELECT INPUT 

R 

R 

R,RR 

RADIAL READY OUTPUT 

I 

I 

RI 

RADIAL INDEX OUTPUT 

I 

I 

X 

HEAD LOAD OPTION 

R 

R 

A,B 

HEAD LOAD OPTIONS 

I 

I 

C 

HEAD LOAD OPTION 

I 

R 

WP 

WRITE PROTECT 

I 

I 

NFO 

STOP AT TRACK 0 

I 

I 

DDS 

DRIVE DECODE OPTION 

R 

R 

DC 

DISK CHANGE OPTION 

R 

R 

HL 

STEPPER PWR-HEAD LOAD 

R 

R 

DS 

STEPPER PWR-DRIVE SEL. 

R 

R 

NP 

NO WRITE PROTECT 

R 

R 

Y 

IN-USE FROM HEAD LOAD 

R 

R 

Z 

IN-USE FROM DRIVE SEL. 

I 

I 

TS 

TRUE FM DATA SEPARATION 

E 

E 

Notes : 

R = jumper removed, I = 

E = removed or installed. 

jumper installed. 


Figure 2 . 1 ^ SHUGART SA850 CONFIGURATION GUIDE. 


The SA850 8 inch drives are double-sided, and can record 
in either the MFM mode (double-density) or in the FM mode 
(single-density) . All signal lines are TTL compatible. Outputs 
are driven by open-collector drivers capable of sinking a maximum 
of 40 ma at a logic zero level (or true state) with a maximum 
voltage of 0.4V at the driving device. Collector current when 
the driver is at a logic one (or false state) and thus off is a 
maximum of 250 microamperes. These specifications are typical of 
most drives as well as the devices in the SB180 system board 
flexible-disk interface area. 
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Addendum ; To add an 8** Shugart b5k)/8bu DS/DD drive to an 
SB180 with two 5,25‘V3.S" drives^ the following ^ua^pers should 
in place: 

2S 

Z 

A 

B 

I 

R 

IW 

S2 

IT 

C 

RS 

HLL 

* M ‘ 

NF 

DS3 

There should be no terminator on the drive. 



Installation of more than two drives is essentially the 
same as for two drives. Set up the drives for drive select num- 
bers from 0 on up in ascending order, and install the resistor 
terminator jumpers in the drive which is physically the last 
drive in the daisy-chain. On mixed size drive systems (both 34 
pin and 50 pin connector cables) install the drive terminator on 
the longer of the two cables. 

Installation of newer models of 8 inch drives is generally 
simpler than for the SA850. 

Power requirements for the SA850 disk drives are +24 VDC 
at 1.3 a, +5 VDC at 0.8A, -5 VDC at 0.05A (newer drives do not use 
this), and 115 VAC at 0.5 amperes. DC currents are typical 
values, while AC current is a maximum value. 


2.8 The Expansion Bus 

The SB180 system board can support expansion cards through 
its I/O expansion bus which is accessed through the 40 pin con- 
nector J5 and the 8-pin connector J6. Figure 2.8-1 illustrates 
the signal pin-out of these connectors. Because all of the major 
peripheral devices which are needed to support a high performance 
Z-System based microcomputer system are supported by on-board 
controllers, the expansion bus is only needed for expansion 
peripherals such as a hard disk controller, a "smart" modem, cus- 
tom I/O interfaces such as data acquisition controllers, a local 
area network (LAN) interface, or graphics display controller. 
The only factor which might limit the use of the expansion con- 
nector is the rating of your system power supply, so be sure that 
your power supply capacity is adequate for continued reliable 
operation. 

When designing custom interfaces, serious consideration 
must be given to the fact that the busses on the SB180 are oper- 
ating at 6-9 MHz. Long extensions to the busses and bus over- 
loading must be avoided. 

As always, the first step to take prior to the insertion 
or removal of any expansion card(s) is to ensure that POWER HAS 
BEEN REMOVED from the SB180 system board. 

The next step is to thoroughly read the installation pro- 
cedures which come with the expansion card. Follow the proced- 
ures given and install the card using connector J5. If all goes 
well the card should now be up and running. 
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EXPANSION BUS 


IPTION 

PIN 

1 # 

DESCRIPTION 

+5V PWR 

1 

2 

+5V PWR 

GND 

3 

4 

GND 

-RD 

5 

6 

PHI 

-WR 

7 

8 

-RESET 

E 

9 

10 

-LIR 

-NMI 

11 

12 

-EXP SEL (E0 

-WAIT 

13 

14 

NC 

-INT0 

15 

16 

-HALT 

ST 

17 

18 

NC 

A0 

19 

20 

A1 

-TEND0 

21 

22 

A2 

A3, 

23 

24 

A4 

-DREQ0 

25 

26 

-I/O ENABLE 

8.0 MHZ 

27 

28 

RESET 

D7 

29 

30 

D6 

D5 

31 

32 

D3 

D4 

33 

34 

D2 

D1 

35 

36 

D0 

GND 

37 

38 

GND 

NC 

39 

40 

NC 


J5 


Notes: 1. Micromint expansion bus 40 pin header is P/N SB180~EX 
2. J6 and its driver IC are generally not populated on 
the SB180, Expansion boards which require the address 
decode function will supply the chip and connector. 


Figure 2.8-1 EXPANSION BUS SIGNALS 


2.9 Installation of User EPROM 

The SB180 contains a 28-pin socket for a capacity of up to 
32K bytes of JEDEC standard ROM or EPROM devices. The standard 
SB180 system board is shipped with a stand alone monitor 
installed in a Erasable Programmable Read Only Memory (EPROM) 
device. This consists of one 8Kx8 2764 or 16Kx8 27128 type 
EPROM. This EPROM contains the power-on jump vector. 
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A single jumper is associated with the type of EPROM 
device which is installed on the system board. This is JPl. 
Refer to the silkscreen drawing of figure 2.1-1 for the location 
of this jumper. If the standard 2764 EPROM or a 27128 EPROM is 
used, the jumper should be in the factory wired position. If a 
32K 27256 EPROM is ever installed, the jumper must be cut on the 
circuit side of the board and a wire installed in the opposite 
position . 


2.10 SB180 Installation Checklist 

This section is intended to serve as an overall guide to 
the sequence of steps which should be taken during the install- 
ation of an SB180 system. Before commencing the actual install- 
ation of the hardware components, sections 2.1 through 2.10 
should be read to get an idea of the scope of the project about 
to be undertaken. Once this has been done, proceed to the check- 
list given below in figure 2.10-1. After all steps in the check- 
list have been completed, use section 2.11 to start up the SB180 
system and verify correct operation. 


2.11 Turning On Power With Disk Drives Attached 

This section describes the procedure for turning on power 
to the standard SB180 system after the completion of the system 
installation procedures given in section 2.4 of this manual and 
after installation of disk drives as detailed in section 2.7 of 
this manual. 

It is assumed in this section that the Z-System operating 
system has been purchased with the SB180 system board, and that 
the user is somewhat familiar with the terminology used by Z- 
System. Users who are not already conversant with Z-System 
should read the operating system user's guide before trying to 
use the SB180 system. 
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STEP DESCRIPTION 

1. Read sections 2.1 through 2.10. 

2. Unpack the SB180 system board and inspect it for 
damage. If damage is evident, return to vendor. 

3. Using section 2.2 as a guide, install the system 
power supply(s). 

4. Using section 2.3 as a guide, install the system 
console RS-232C serial device. 

5. Using section 2.4 as a guide, check out the SB180 
ROM monitor with the console device connected. 

6. Using section 2.5 as a guide, install the system 
auxiliary RS-232C serial device if needed. 

7. Using section 2.6 as a guide, install the system 
listing device (parallel printer) if needed. 

8. Using section 2.7 as a guide, install the system 
flexible disk drive(s). 

9. Using the information in section 2.9, verify 
the jumper configuration for the EPROM devices. 

10. Use section 2 to verify correct functional 
operation of the basic SB180 system. 

11. Using section 2.8 as a guide, install expansion 
cards as required. 

12. If expansion cards were added in step 11, repeat 
step 10. 

13. Now operate the SB180 under Z-System! ! ! 


Figure 2.10-1 INSTALLATION CHECKLIST 


DONE 
( ) 
( ) 

( ) 

( ) 

( ) 

( ) 

( ) 

( ) 

( ) 

( ) 

( ) 

( ) 
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STEP 1 & STEP 2 SAME AS SECTION 2.4, STEPS 1 & 2 

Follow the instructions as given in section 2.4 of this 
manual, steps 1 and 2. 

Open the door(s) of the flexible disk drive (s) and remove 
the piece of cardboard which may be inserted in place of a disk- 
ette for shipping, if not previously done. 

If this is the first time the SB180 system is being powered 
up, it is recommended that any expansion board be removed until 
the basic system is up and running. If cards are to be installed 
on the expansion connector at this time, check them to ensure 
that they are seated properly into the 40 pin and (optionally 8 
pin) connector (s) with the component side(s) facing up. 


STEP 3: TURN ON POWER AND BACK UP THE Z-SYSTEM DISK 

The SB180 system should now be ready for you to make back 
up copies of the Z-System system diskette using drive number 0 
(or drive A as it is referred to by Z-System) . Z-System is a 
disk operating system, or DOS as they are commonly referred to, 
which was designed by Echelon, Inc. to be fully compatible with 
CP/M 2.2. This is simply a collection of programs stored on the 
diskette which will enable you to create and execute (run) 
programs on the SB180 system. 

A FEW WORDS OF CAUTION 

Before proceeding any further, the flexible-diskettes 
which are used for program and data storage by the SB180 system 
will be discussed. Users familiar with the use and handling of 
diskettes should skip the next several paragraphs. 

While diskettes can handle a large amount of information, 
they are somewhat fragile and need to be treated with respect. 
Although they are flexible, they can be easily damaged if they 
are bent or scratched, or if any foreign matter such as dust, 
hair, or grease from fingerprints is allowed to touch the surface 
of the diskette itself. Diskettes should only be handled by the 
black plastic cover which protects them, and should be stored in 
the paper covers they come in when not in use. Don't leave them 
lying around where they will collect dust or be dropped on the 
floor. In addition, diskettes should be kept away from extremes 
in temperature and away from magnetic fields. Always use felt- 
tip pens to write on the diskette labels to avoid damaging the 
surface of the diskette. 

To insert diskettes into a disk drive, first open the 
drive door (different drives have slightly different door 
mechanisms) . This is usually done by pulling outward on the edge 
of the door, or in some cases, by pushing in on a door release 
mechanism. Diskettes can then be inserted into the slot in the 
drive with the end of the diskette which has the oval cutout 
leading the way. The side of the diskette which has the manu- 
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facturer's label usually faces the drive door, and always enters 
the drive last. Diskettes should always be GENTLY pushed into, 
the drive, taking caution not to bend them; this can result in 
permanent damage. Once the diskette is fully inserted into the 
drive, close the drive door by pushing it down. Removing disk- 
ettes is accomplished by opening the drive door and carefully 
pulling the diskette out of the drive, again taking caution not 
to bend the diskette in the process. Finally, it is never a good 
practice to remove a diskette when the drive is being accessed 
since this can accidentally destroy the programs which are stored 
on it. Most drives have an "in-use" light which indicates that 
they are being accessed. 

Since you certainly don't want to accidentally erase any 
of the Z-System operating system programs which were just pur- 
chased, the Z-System master diskette should be "write protected". 
For the 5.25" disk on which the Z-System is supplied, this is 
done by installing a foil tab which is placed over a "write 
protect" notch in the upper right hand side of the diskette. 
When the foil tab is in place, the diskette is "write protected" 
and the diskette cannot be written on. Eight-inch drives, on the 
other hand, are write enabled when the foil tab is installed (on 
the lower right side of the diskette) , and write protected when 
it is removed. 

Since only one copy of the Z-System operating system 
master diskette is provided, it is advisable to make a back-up 
copy of the diskette to use when actually operating the SB180 
system. It is a standard practice to operate microcomputer 
systems from back-up copies of diskettes instead of the orig- 
inals, which are usually stored in a safe place. This is just a 
safety precaution in that a new copy can be made if the working 
diskette becomes damaged or worn out. 

START THE SYSTEM FROM THE MONITOR ROM 

Open the door of the disk drive, insert a blank diskette 
(make sure it is not write-protected) , but keep the door of the 
drive OPEN. The SB180 system monitor which is stored in the on- 
board EPROM devices, will sense the baud rate of your attached 
console device only when the monitor mode is entered, and the 
SB1B0 will power up in the monitor mode only if it senses that 
the disk drive is NOT ready. (If you close the disk drive door 
before applying power, the system assumes a 9600 baud rate for 
your console and will directly boot Z-System upon application of 
power.) You will now use the monitor's "K" and "C" commands to 
format two blank disks and make two back up copies of your Z- 
System disk. You will then boot Z-System for the first time from 
one of the copies. 

Turn on power to the console I/O device, to the flexible 
disk drive(s), to the printer if one is attached and to the SB180 
system board, in that order. As described in section 2.4, the 
ROM monitor will be waiting for you to enter a character from the 
keyboard. Do so, and you will see the familiar monitor prompt, 
0>. Enter "K0 40 <CR>" to format the blank disk in drive 0. The 
monitor will ask for confirmation and then format the disk. 
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After the first disk is formatted, remove it and repeat the oper- 
ation with the second blank disk. Remove this disk and place the 
write protected Z-System disk in the drive and enter ”C0 0" to 
tell the monitor to make a single drive copy. The monitor will 
prompt you to "swap” source (Z-System) and destination (the copy) 
disks as necessary. Repeat this operation so that you have two 
copies of the Z-System disk, one for back up and the other for a 
working master copy. Insert the working master copy into the 
drive . 


STEP 4 BOOT THE OPERATING SYSTEM 

You should still see the familiar monitor prompt. Close 
the disk drive door. Now enter the "Z" command to boot the Z- 
System operating system. If the Z-System operating system was 
successfully read from the diskette and loaded into system RAM, 
the following message will be printed on the screen: 

SB180 56K Z-System Ver x.x 

If the above message does not appear on the screen, open the door 
of the disk drive, turn power to the SB180 system off, wait a few 
seconds, and try to start the system up again. Sometimes the 
diskette will not center completely in the drive when the drive 
door is closed. If the Z-System prompt still does not appear, go 
to the "IN CASE OF DIFFICULTY" section. The x.x shown above 
represents the version number of the operating system. You will 
also see information relating to the terminal configuration 
program which will make available terminal-specific information 
to the operating system for use by utility programs. 

You will be presented with a list of terminals. Use the 
+ and - keys to move among the pages of terminal names. When you 
find the name of your terminal, enter the letter displayed next 
to it. This will create the file MYTERM.Z3T which contains in- 
formation about your terminal to be used later by various system 
utilities. If you did not find your terminal on any list, press 
ESC to abort and enter TCMAKE. This allows you to describe your 
terminal to the system in detail for later use. (You should have 
your terminal manual available for this step.) Note; if at any 
time you wish to change your terminal description, use the ERAse 
command to destroy the MYTERM.Z3T file. Reboot the system and 
you again will able to select a new terminal. 

After you have successfully configured Z-System to your 
terminal, you should then see "A0:BASE>"; this symbol is the Z- 
System system prompt that tells you that Z-System is ready to 
receive a command from the console device keyboard, and that 
drive A, user area 0 is the system default drive. Unless Z- 
System is told to do otherwise (with the PATH command) , it will 
try to find all program and data files on drive A, user area 0. 

At this point the basic SB180 system should be up and 
running. If it is not, run the SB180 system from the monitor, 
make a new copy of the master Z-System disk, and try again. If 
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the back-up copy still will not boot up the system, refer to the 
"IN CASE OF DIFFICULTY" section. You might want to try running 
some of the example programs in the Z-System operating system 
users guide in order to become familiar with your SB180 system. 


STEP 5 CHECK THE PARALLEL PRINTER DEVICE. 

If your system does not have a printer device skip this 
step. The Z-System operating system will now be used to test the 
installation and operation of the printer device. We will use 
the printer toggle, CTRL-P (or/'P) to send all of the characters 
typed in at the console serial input device to the printer. To 
enter a CTRL-P, you use the key marked CTRL as if it were a Shift 
key, holding it down while pressing the "P" key next. From this 
point on, everything typed in at the keyboard will also appear on 
the printer. To "toggle" the printer off, enter another CTRL-P. 

Type in several characters such as letters and numbers 
(try to avoid control keys which might be non-printing char- 
acters) and verify that they are echoed onto the printer device. 
If they are not, or if they do not match those which you have 
typed in go to the "IN CASE OF DIFFICULTY section. Characters 
will continue to be sent to the printer device until a second 
CTRL-P character is entered which tells Z-System that the printer 
should be toggled off. 


2.12 In Case of Difficulty 

If the SB180 system is not functioning correctly, this 
section may be useful in correcting the problem. The information 
given here is not intended to encompass full-fledged trouble- 
shooting of the SB180 system board. That is best left to tech- 
nicians who have the necessary test equipment required because of 
the complexity of the logic on the system board. This section is 
meant to help you isolate common installation mistakes to get 
your system up and running for the first time. The information 
given in figure 2.12-1 should direct you to the appropriate step 
to go to for help. 
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SYMPTOMS 


POSSIBLE CAUSES 


STEPS 


System appears to be 1. Power problem. 2 

totally dead. 2. Console cable. 1,3 

3. Console configuration. 1,3 

4. Expansion cards. 1 

5. Defective console device. 3 

Disk drive goes on but 1. Console brightness adjust. 3 

no characters appear on 2. Console cable. 1,3 

the display. 3. Console configuration. 3 

4. Defective console device. 3 

Wrong/garbage characters 1. Console configuration. 3 

appear on display. 2. Defective console device. 3 

Correct power-on message 1. Disk drive power problem. 2,4 

but no Z-System prompt; 2. Diskette inserted wrong. 4 

disk I/O error messages. 3. Disk interface cable. 1,4 

4. Disk configuration. 4 

5. Bad system diskette. 4 

6. Defective disk drive(s). 4 

7. No termination resistor. 4 

Printer types wrong 1. Printer cable. 1,5 

characters or none at 2. Printer configuration. 5 

all. 3. Defective printer device. 5 


Figure 2.12-1 TROUBLESHOOTING CHART. 


STEP 1: CHECK CONNECTIONS. 

Most of the difficulties which will arise in the initial 
installation of an SB180 system can be traced to either an I/O 
interface cable with wires on the wrong pins, or to an improper 
configuration of the SB180 system board option jumpers or those 
of an external I/O device. In this step just check to see that 
all cables are properly attached to their mating connectors. 

Turn off power to the SB180 system and attached peripher- 
als, and check all cables for a good connection. Then repeat the 
procedure given in section 2 for starting up the system. 
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STEP 2; VERIFY POWER SUPPLY VOLTAGES. 

It is always a good idea to verify that the system power 
supply voltages are in the required voltage range, usually plus 
or minus 5% of the nominal value. Sometimes systems will appear 
to work if the voltages are close to the required values, but 
will typically "crash" often, or act strangely during operation. 
A voltmeter or an oscilloscope will be needed- to measure the 
power supply voltages. 

Measure all DC voltages for both the SB180 system board 
and for the disk drives, and verify that the voltage levels are 
within the specified tolerances of the power supply. The volt- 
ages on the SB180 system board can be measured at the I/O ex- 
pansion connectors. If voltage readings are OK, the problem lies 
elsewhere. If the power supply readings are incorrect, but with- 
in a volt or two of the nominal value, adjust the voltage adjust- 
ment potentiometer (s) on the power supply, if there is one, such 
that the output (s) is at the correct level. On switching type 
power supplies you may have to add more load to the +12- volt out- 
put to bring the +5 volt output into regulation. If this adjust- 
ment corrects the power supply readings, go back to section 2 and 
try to run the system again. 

If voltages under full load are low, recheck the rating of 
your power supply to insure that it can handle both the average 
(normal) load as well as the peak load (see your disk drive man- 
ual) . 

If the power supply reading is way off, for instance, +12V 
instead of +5V, or 0V, the power supply cable is probably wired 
to the wrong pins. If this is the case, you may have destroyed 
the components on the SB180 system board. Recheck the power 
supply cable pin-outs and correct any wiring errors if any are 
found. Turn power back on and measure the voltages again. If 
the readings are now OK, go back to section 2 and try to run the 
system again. If the readings are still incorrect^ the likely 
cause is the power supply itself. Disconnect the power cable (s) 
from the supply and measure the voltages under a no-load con- 
dition. If the supply will not regulate without a load (this 
should be stated on the specification sheet for the power supply) 
a "dummy load" which is usually just a power resistor of suffi- 
cient wattage must be placed across the output (s). If the volt- 
age readings are still not correct, replace the power supply. 


STEP 3: CHECK THE CONSOLE DEVICE. 

Problems associated with a serial device are almost always 
due to an incorrect cable or jumper configuration. The important 
thing to remember is that the device at one end must be operating 
as Data Communications Equipment (DCE) , and the device at the op- 
posite end of the cable must be operating as Data Terminal Equip- 
ment (DTE) , or the signals must be reversed in the cable assem- 
bly. If there is no response at all then suspect either the 
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cable, or the configuration of the operating mode, DCE or DTE. 
If characters are appearing but make no sense, suspect one of the 
configuration settings such as baudrate, parity or stop bits. 

Operation of the console serial device can be easily veri- 
fied if it is placed into a local-echo mode of operation. In 
this mode, each keystroke is echoed back on the display screen as 
it typed. Turn off power to the terminal and put the terminal 
into a local-echo mode if it has one. Another way to accomplish 
this function is to make a test connector which has pin numbers 2 
and 3 shorted together, pins 4 and 5 shorted, and pins 6 and 20 
shorted. This test connector would be attached to the terminal 
instead of the console serial cable of the SB180 .system. 

First ensure that the terminal is plugged into an AC out- 
let and that power is turned on. At this point, even if the 
SB180 system board was not connected to the terminal, a cursor 
should appear somewhere on the screen. The cursor is typically a 
blinking box. If no cursor appears, try to adjust any brightness 
or contrast controls (these may be located on the rear of the 
terminal) until the cursor becomes visible. If no cursor appears 
at all, the problem is probably in the terminal. In that case 
refer to the manual for the terminal for troubleshooting 
procedures. 

If a cursor is present on the display screen, and the 
terminal has been placed in a local-echo mode, try typing in some 
characters. These should be displayed somewhere on the terminal 
screen. If no characters appear, disconnect the serial cable 
attached to the SB180 console I/O connector if it is still at- 
tached, and try typing in some more characters. If characters 
now appear, there is probably an incorrect connection in the 
cable. If there still aren't any characters displayed, it is 
likely that there is something wrong with the terminal, so refer 
to the manual for the device and follow the troubleshooting 
procedures given there. 

Now that characters are appearing on the display terminal 
in the local-echo mode, turn off power to the system and recon- 
nect the console serial cable to the SB180 system board. Run the 
system again as described in section 2 of this manual. If the 
messages which should be displayed are a meaningless string of 
characters, or perhaps the terminal just does weird things in- 
cluding a lot of beeping, there is probably a mismatch between 
the SB180 and the terminal in one of the operating parameters 
(such as baud rate, parity, etc.). Turn off power to the SB180 
system and check the switch/jumper settings on the display term- 
inal device and ensure that the baudrate, parity and stop bits 
are correct. Correct any which are in the wrong position or 
setting . 


Turn power back on and follow the start up procedure given 
in section 2. If the SB180 system is still not displaying the 
correct start-up messages at this point, there may be something 
wrong with the hardware, and the system board should be returned 
for repair. Call for a return authorization number prior to 
returning any equipment to Micromint. 
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STEP 4: CHECKOUT THE DISK DRIVE (S). 

Problems in interfacing the SB180 system board with the 
flexible disk drives are usually attributed to four areas: a bad 
interface cable/configuration; wrong jumper/switch configurations 
on the disk drive(s) , the SB180 system board, or both; incorrect 
power supply voltages; or non-functioning diskette (inserted 
wrong, or a damaged diskette) . During initial installations, the 
first two areas will usually be the cause of the problem. 

The first thing to do is to verify the power supply con- 
nections, and to measure the voltages to check that they are all 
within the prescribed tolerances, usually plus or minus 5% of the 
nominal value. This should have been done in step 2 above. If it 
wasn't, refer to step 2 again and make the voltage measurements 
and adjustments if needed. The actual voltages used depends on 
the type of disk drive as indicated in the disk installation sec- 
tion (2.7). If any adjustments were made, go back and repeat the 
procedures given In step 2. 

No matter what kind of problem occurs in the disk drive 
interfacing, about the only thing which can be done to find and 
correct the problem is to once again recheck the wiring of the 
cable and the position of configuration switches and jumpers. 
Both of these are described in section 2.7. There are no user 
adjustments in the disk controller logic circuitry of the SB180 
system board. 

Avoid attempts at disk drive "adjustments" until you have 
a fully operational SB180 system and the proper calibration and 
test equipment. 

Using the drive's manual or specification sheet, and the 
signal pin-out for the appropriate interface connector on the 
SB180 system board, verify signal connections on the disk drive 
interface cable. If any errors are found, correct them and go 
back and re-try the start-up procedures of section 2. 

Using the drive's manual if it is available, and the ex- 
ample installation information of section 2.7.1 or 2.7.2 as a 
guide, verify that each disk drive is configured correctly. If a 
drive manual is not available, and the drive type is not the same 
as the one used as an example in the installation section, write 
the manufacturer of the drive to find put how to configure the 
drive. In general, the disk drives should be set up in the 
following manner: 

1) Multiple drives attached in a "daisy-chain", 

2) Terminators installed on all "radial" signals, 

3) Terminators installed only on the drive at the end 
of the interface cable for "multiplexed signals, 

4) Radial drive select signals. 
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5) All other signals must be multiplexed, 

6) 8-inch drives must have stepper motor power on at 
all times unless a motor-on control function is 
available on the drive unit. 

Radial signals are those for which a separate signal exists for 
each drive. Multiplexed signals are those which are shared by 
all of the disk drives in the system. The drive currently 
selected must be the only one to activate the multiplexed signal 
lines . 


Now use the jumper configuration table for the SB180 sys- 
tem board given in section 2.6 to verify the option selections on 
the system board. Most of the jumper options are associated with 
the drive type, 5.25 inch {and 3.5 inch), or 8 inch, and have 
mandatory positions for each type as listed in figure 2.7-1. The 
only jumpers which you have to decide whether to install or 
remove are those numbered JP6-10. These jumpers are totally 
dependent on configuration of the drive units, and will vary from 
installation to installation. These jumpers are discussed in 
section 2.7. If any configuration errors were discovered, 
correct them and then retry the start-up procedures of section 
2.11. If the disk circuitry is still not functioning correctly, 
it is time to get helpl 


STEP 5 CHECKOUT THE PRINTER DEVICE 

There isn't a whole lot which can go wrong in the install- 
ation of a printer. Either the wiring of the interface cable is 
not correct, or the polarity of control signals is reversed. 

First check to see if the printer is plugged into an AC 
wall outlet, and that the power is turned on. Now use the print- 
er manual and check that any operational switches such as the 
printer select switch is in the correct position. Of course, the 
printer must have paper in it! If you found anything wrong up to 
this point, make the indicated corrections and then go back to 
step 7 of section 2 and test the printer again. 

If the printer still does not work, use the printer manual 
and the installation notes of section 2.6 in this manual to ver- 
ify printer cable wiring. If any errors are found, correct them 
and try the printer test procedure again. 

The last area to check is the logic signal polarity of the 
printer control signals. Of particular importance is the DATA 
STROBE* and DATA ACKNOWLEDGE* signals, both of which are init- 
ialized by the SB180 as active low. If any corrections need to 
be made here, they must be done via a call to a software routine 
which must be written for that purpose. 
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3.0 Hardware Technical Descriptions 

The information in this section provides technical de- 
scriptions of the SB180 hardware components. Schematics for the 
SB180 board hardware are included in Section 5. Separate hard- 
ware components such as disk drives, printers, or serial devices 
are not described in this manual. Refer to the technical or user 
manuals for other devices if technical data is required for them. 


3.1 The Hitachi HD64180 

The power of the SB180 is made possible by the Hitachi 
HD64180 - a microcoded execution unit based on advanced CMOS 
manufacturing technology. It provides the benefits of high 
performance, reduced system cost and low power operation while 
maintaining complete compatibility with the large base of stan- 
dard CP/M software. 

Performance is derived from a high clock speed (6 MHz 
now, 9 MHz in the near future), instruction pipelining, and an 
integrated Memory Management Unit (MMU) with 512K bytes memory 
address space. The instruction set is a superset of the Z80 
instruction set; twelve new instructions include hardware multi- 
ply, DMA, and a SLEEP instruction for low power operation. 

Considered to the Z-80 what the 80188 is to the 8088, 
system costs are reduced because many key system functions have 
been included on-chip. Besides the MMU, the HD64180 boasts a two 
channel Direct Memory Access Controller (DMAC) , wait state gener- 
ator, dynamic RAM refresh, two channel Asynchronous Serial Com- 
munication Interface (ASCI), Clocked Serial I/O port (CSI/0) , two 
channel 16-bit Programmable Reload Timer (PRT) , a versatile 12 
source interrupt controller, and a "dual" (68xx and 80xx fam- 
ilies) bus interface all on one 64 pin chip. Table 3.1-1 com- 
pares the HD64180 with other 8 bit processors. 



HD64180 

8080/Z80 

NSC800 

Z800 

80188 

Process 

CMOS 

NMOS 

CMOS 

NMOS 

NMOS 

Power 

100mw 

IW 

100mw 

2W 

2W 

Max. Clock 

10 MHz 

8 MHz 

4 MHz 

10 MHz 

8 MHz 

Address Space 

512 K 

64 K 

64 K 

512 K 

1 M 

UARTs 

2 ch . 

no 

no 

1 ch. 

no 

DMAC 

2 ch. 

no 

no 

4 ch. 

2 ch . 

TIMERS 

2 ch. 

no 

no 

4 ch. 

2 ch. 

Clocked SIO 

yes 

no 

no 

no 

no 

CS/Wait Logic 

yes 

no 

no 

yes 

yes 

DRAM Refresh 

yes 

yes (Z80) 

no 

yes 

no 

Note; The 

availability 

of the 

Zilog Z800 

at this 

time i 


unknown and specifications on the Z800 are subject to change. 


Table 3.1-1 COMPARISON OF SOME 8-BIT PROCESSORS 
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The HD64180 CPU is comprised of five functional blocks: 

o Central Processing Unit - The CPU is microcoded to imple- 
ment an upward compatible superset of the Z80 instruction set. 
Besides the twelve new instructions, many instructions require 
fewer clock cycles for execution than on a standard Z-80. 

o Clock Generator - The clock generator generates the system 
clock from an external crystal or external clock input. The 
clock is programmably prescaled to generate timing for the on- 
chip I/O and system support devices. 

o Bus State Controller - The bus state controller performs 
all status/control bus activity. This includes external bus 
cycle wait state timing, RESET*, DRAM refresh, and master DMA bus 
exchange. It generates "dual-bus" control signals for compat- 
ibility with both 68xx and 80xx family devices. 

o Interrupt Controller - The interrupt controller monitors 
and prioritizes the four external and eight internal interrupt 
sources. A variety of interrupt response modes are programmable. 

o Memory Management Unit - The MMU maps the CPU's 64K byte 
logical memory address space into a 512K byte physical memory 
address space. The MMU organization preserves software object 
code compatibility while providing extended memory access and 
uses an efficient "common area - bank area" scheme. I/O accesses 
(64K bytes I/O address space) bypass the MMU. 


The integrated I/O resources comprise the remaining four 
functional blocks; 

o Direct Memory Access Controller - The two channel DMAC 
provides high speed memory- to-memory, memory-to-I/0, and memory- 
to-memory-mapped I/O transfer. The DMAC features edge or level 
sense request input, address increment/decrement/no-change, and 
(for memory-to-memory transfer) programmable burst or cycle steal 
transfer. In addition, the DMAC can directly access the full 
512K bytes physical memory address space (the MMU is bypaseed 
during DMA) and transfers (up to 64K bytes in length) can cross 
64K byte boundaries. At 6 Mhz, DMA is 1 Mbytes per second. 

o Asynchronous Serial Communication Interface - The ASCI 
provides two separate full duplex UARTs and includes programmable 
baud rate generator, modem control signals, and a multi-processor 
communication format. The ASCI can use the DMAC for high speed 
serial data transfer, reducing CPU overhead. 

o Clocked Serial I/O Port - The CSI/0 provides a half duplex 
clocked serial transmitter and receiver. This can be used for 
simple, high-speed connection to another microprocessor or micro- 
computer . 
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o Programmable Reload Timer - The PRT contains two separate 
channels each consisting of 16-bit timer data and 16-bit timer 
reload registers. The time base is divided by 20 (non-program- 
mable) from the system clock, and one PRT channel has an optional 
output allowing waveform generation. 


3.2 SB180 Design Criteria 

With all this functionality on one chip, only a few 
additional chips are needed to implement a truly sophisticated 8- 
bit single board computer in a small space (less than 30 sq. 
in.). In terms of the original Altair micro of less than 10 
years ago, the functionally equivalent machine would have taken 
about 35 S-100 boards for a total of 1750 sq. in. (using 8K 
memory boards!). 

In order to reduce chip count further, an enhanced flop- 
py disk controller chip from Standard Microsystems Corporation, 
the FDC 9266, was chosen. This 40-pin DIP chip is software com- 
patible with the industry standard NEC 765A floppy controller and 
adds an on-chip digital data separator to the functions of the 
FDC 9229 floppy disk interface chip as well. It is compatible 
with single and double sided 3 1/2", 5 1/4" (40 and 80 track) , 
and 8" drives; the data separator handies both single density (FM 
encoded) and double density (MFM encoded) data. This means that 
it can be programmed to read and write almost all soft-sectored 
CP/M disk formats (and MS-DOS disk formats). 

With the HD64180 's two channel ASCI built in, two serial 
ports were included into the design automatically, and provision 
was made for a Centronics parallel printer port as well. Since 
256K DRAM chips are now plentiful and inexpensive, 8 of these 
were used for memory (64K DRAMs may also be used) . Because only 
64K bytes of this is usually used for the logical memory space, 
the user can optionally designate the other 192K bytes as a RAM 
disk in the operating system. Of course, it may also be used for 
other purposes (such as implementing banked memory for CP/M 
Plus) . 


3.3 The SB180 Hardware 

Figure 5.1 is the schematic of the SB180 computer. Its 
design is primarily characterized by the high performance, high 
density MOS devices including 256 Kbyte DRAMs. 

The SB180 system design implements the following function- 
al blocks : 

CPU 

Memory Interface 

RS-232 Interface 

Centronics Printer Interface 

Floppy Disk Interface 

XBUS Expansion Bus 

Power Supply 
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3.3.1 


CPU 


The HD64180 is a high system integration device which 
combines a CPU execution unit with a number of basic system and 
peripheral functional blocks. These include: 

CPU 

MMU - Supports 512KB address space 

DMAC - 2 channels 

ASCI - 2 channel UART with baud rate generator 

CSI/0 - 1 channel clocked serial I/O 

PRT - 2 channel, 16 bit programmable reload timer 

Wait State Generator 

DRAM Refresh Controller 

Interrupt Controller - 12 interrupt sources 

The HD64180 requires operation at specific frequencies 
in order to generate standard baud rates. Standard operating 
frequency for the SB180 is 6.144 MHz (12.288 MHz crystal). Other 
operating frequencies which maintain standard baud rates are 
3.072 MHz, 4.608 MHz and (later) 9.216 MHz. 


3.3.2 RS-232 Interface 

The HD64180 ASCI two channel UART is connected to 1488/ 
1489 RS-232 line drivers/receivers to provide two separate ports. 
ASCI channel 1 is used for the CONSOLE, while ASCI channel 0 is 
used for AUXILIARY RS-232 devices such as printers, plotters and 
modems. This distinction is made because modems require the 
extra handshakes which are available with ASCI channel 0, while 
terminals do not. All primary RS-232 parameters (baud rate, 
handshaking, data format, interrupts) are software programmable. 


3.3.3 Memory Interface 

The SB180 incorporates a 28 pin JEDEC boot ROM socket 
which can be jumpered to hold 8Kx8, 16Kx8 and 32Kx8 memory de- 
vices. The boot ROM (contains disk boot and ROM monitor) occu- 
pies the bottom 256K bytes of the HD64180 physical address space 
since it is selected whenever A18/T0UT (note: the TOUT timer 
output function is not used) is LOW. Thus, the boot ROM contents 
(whatever its size) is simply repeated in the lower 256KB. The 
boot ROM output (OE*) is enabled by the HD64180 ME* (memory en- 
able) signal. (As configured, the maximum RAM memory on the 
SB180 is 256K. To support larger memories, additional address 
decoding would be required to designated RAM and ROM areas in the 
current 256K boot ROM space.) 

The critical ROM timing parameter is Tee (access time from 
CE*) . 200ns (and marginally, 250ns) ROMs can operate with 1 wait 
state. 


At RESET*, the HD64180 begins execution at physical 
address OOOOOH, the start of the boot ROM. 
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ADDRESS 


DATA 

BUFFER 


BUFFER 





PIN ASSICNMCNT 



H0C4180 


VssC 

1 

84 

□ ♦ 

XTAL C 

2 

83 

□ RO 

EXTAC C 

3 

82 

□ ^ 

WAIT C 

4 

81 

D CTr 

BUSACK C 

5 

80 

□ e 

busreq c 

8 

59 

□ ME 

RESET C 

7 

58 

□ I'OE 

nkTi c 

8 

57 

□ REF 

INTO C 

9 

58 

□ halt 

INTI C 

10 

55 

□ tenoi 

INT2 C 

11 

54 

□ OREOr 

stC 

12 

53 

□ CKS 

AOC 

13 

52 

□ Rxs/cTsi 

A1 C 

14 

51 

D TXS 

A2C 

15 

50 

□ CKAl/TENOO 

A3C 

18 

49 

□ RXAl 

A4C 

17 

48 

3 txai 

A5C 

18 

47 

3 CKAO/DREQO 

A^C 


48 

□ RXAO 

a;c 

20 

45 

3 txao 

A8C 

21 

44 

□ 0^ 

A9C 

22 

43 

□ CTSO 

AlOC 

23 

42 

13 rTso 

AUC 

24 

41 

□ 07 

A12C 

25 

40 

3 08 

AUC 

25 

39 

□ 05 

A14C 

27 

38 

3 04 

AlSC 

28 

37 

□ 03 

A16C 

29 

38 

□ 02 

A17C 

30 

35 

□ 01 

Aia/OUTCl 

31 

34 

3 00 

VccC 

32 

33 

□ Vss 


00-07 


Figure 3.1-2 BLOCK DIAGRAM AND PIN-OUT OF THE HD64180 
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3.3.4 


256K Bit Dynamic Ram 


Standard 256 Kbit 150 nsec DRAMs, requiring 256 refresh 
cycles (8 bit refresh address) every 4 ms are used. These RAMs 
occupy the top 256K bytes of the HD64180 512KB physical address 
space. 


The interface is quite straightforward. Complete DRAM 
refresh control is provided by the HD64180 in conjunction with 
control logic U16 and Ul8 and address muxes U12, U13 and U17. 

The HD64180 WR* output directly generates DRAM WE*. The 
HD64180 ME* output directly generates RAS*. During normal read/ 
write cycles (Al8 HIGH, REF* HIGH) CAS* goes LOW at the next ris- 
ing edge of phi following the rising edge of E (Enable) . This 
provides plenty of set-up time for the address muxes since the 
rising edge of E switches the address muxes from row to column 
addresses . 

RAS* only refresh is used. The HD64180 generates the 
refresh addresses. During refresh cycles (REF* LOW) , ME* gener- 
ates RAS* while CAS* is suppressed at U16. 

The HD64180 can be programmed to generate refresh cycles 
every 10, 20, 40 or 80 phi cycles as well as selecting two or 
three clock refresh. Since the DRAM requires a refresh cycle 
every 15.625us (4ms/256), the HD64180 is programmed for 80 cycle 
refresh request since 80 x (1/6.144 MHz) = 13.02 us. Two cycle 
refresh is also programmed. Thus, refresh overhead is only 2.5% 
(2 cycles every 80 cycles) . 


3.3.5 Centronics Printer Interface 

The Centronics printer interface is comprised of 8 bit 
latch U5 and F/F U15. The Centronics port is decoded at I/O 
address 0C0H by U4. To write to the printer, the following 
sequence is used: 

Write data to port 0C1H. 

This sets-up the data to the printer and asserts STB* LOW. 
Write data to port 0C0H. 

This de-asserts the printer STB* signal HIGH> 


When the printer has processed the data, it will return 
the ACK* signal which generates an external interrupt (INT 1*) to 
the HD64180. The interrupt handler clears the interrupt by per- 
forming a dummy output to port 0C0H. 

Write (dummy) data to port 0C0H 

This clears the INT 1* interrupt request. 
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The printer interface is not buffered, so compatibility 
with all printer/cable setups cannot be guaranteed. However, in 
practice, problems should be rare since the software scheme pro- 
vides adequate data setup and hold times. Also, note that this 
printer interface is interrupt driven which allows high perfor- 
mance operation. In a more primitive polling design, excessive 
overhead limits acceptable performance in such applications as 
background print spooling. 


3.3.6 Floppy Disk Interface 

The SMC9266 FDC manages almost all details of the drive 
interface, including data separation and (with external logic U20 
and U21) programmable write precompensation. The SMC9266 
actually combines a NEC 765/Intel 8272 FDC with SMC's popular 
9229 digital data separator. Thus, from the host CPU side, the 
SMC9266 looks just like these popular devices, including hardware 
and software compatibility. 

The SMC9266 clock is generated by an 8 MHz oscillator 
comprised of a crystal and U20. Jumpers are provided to select 
write precomp and allow 8" floppy disk drives to be interfaced. 

On the CPU side, the key requirements are interfacing 
the SMC9266 with both programmed I/O (CS*) for initialization, 
status check, etc. and with DMA (DRQ, DACK*) for data transfer. 

Programmed I/O is straightforward, with CS* generated 
for I/O address 80H and RD* and WR* directly generated by the 
HD64180. This is the same scheme used to interface with other 
'80 family peripherals. 

DMA is a little more involved. First, DMAC channel 1 is 
used for the FDC since dedicated handshake lines (DREQl*, TENDl*) 
are provided on the HD64180. Since DMAC channel 0 control lines 
are multiplexed (with ASCI clocks) , DMAC channel 0 is used for 
memory-memory DMA. This means the ASCI clock functions are 
available although they, are not currently used in this design. 

For disk DMA, the 9266 asserts DRQ which in turn causes 
HD64180 DREQl* assertion. The HD64180 performs DMA read/writes 
to I/O address 0A0H, which causes the 9266 DACK* to be asserted, 
completing the transfer cycle. After the DMAC programmed number 
of reads/wri tes - has completed , the HD64180 TENDI* output is 
asserted, and after inversion, causes tha 9266 TC (Terminal 
Count) input to be asserted, completing the DMA operation. This 
is typically followed by the 9266 generating an HD64180 INT 2* 
external interrupt. This interrupt service routine can read the 
9266 status to determine if errors occurred, etc. 

However, there is one 'gotcha', fixed by F/F U18 which 
conditions the 9266 DRQ output. It turns out that if 9266 DRQ 
directly generates HD64180 DREQl* the HD64180 may respond too 
quickly. This- is because HD64i80 DREQ* input logic was designed 
to minimize latency, and thus DREQ* can be recognized at a 
machine cycle breakpoint. Unfortunately, the 9266 requires that 
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Figure 3.1-3 BLOCK 




serial- 

interface 

controller 


DATA 

separator 

AND 

PRECOMP 

LOGIC 


— OSK OATA 

-►WOOUT 
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DBi 

— PO 

OB 2 

PI 

OB] 

— PZ 

OB 4 
08] 
08 ( 

REAOY 

OB] 

WRITE PROTECT/ 

DRQ 

TWO SIDE 

INDEX 

OACK 

TC 

FAULT/TRACK 0 

lOX 

MINI 

INT 




ORIVE- 

interface 

CONTROLLER 


OUTPUT 

PORT 


•UNIT SELECT 0 C 

•UNIT SELECT I 
>MFM MODE 

•^ SEEK 
. HEAD LOAD 
• HEAD SELECT 
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HO 
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at least 800ns elapse from the time it asserts DRQ before the DMA 
transfer (DACK*) actually occurs. In other words, when the 9266 
'asks' for service, it really doesn't want it. ..yeti To prevent 
accessing the 9266 too quickly after DRQ, DRQ from the 9266 is 
delayed at U18 before issuing the DREQl* to the HD64180. DRQ is 
delayed by one REF* cycle time. 

Minifloppy double density (MFM) data transfers occur at 
a 250khz data rate. Thus, each byte must be read within 32us. 
The disk driver software reprograms the refresh request rate from 
every 80 phi cycles to every 40 phi cycles prior to disk DMA, and 
then reassigns it back to 80 phi cycles after the disk DMA is 
completed. The 9266 DRQ is delayed from between 40 phi clocks to 
79 phi clocks. This is about 6-14us. Therefore, the 800ns delay 
and 32us data transfer constraint are both met. Note that 8" 
floppy dc^ble density (MFM) is twice as fast (500khz) and re- 
quires service every 16us. This may require refresh rate in- 
crease to every 20 phi cycles to be safe. 


3.3.7 Expansion Bus 

The spare CS* from address decoder U4 (I/O addresses 
0E0H-0FFH) , along with all major busses (address, data, control) 
are routed to the XBUS . This allows an I/O expansion board cap- 
ability. The full complement of HD64180 control signals (lOE*, 
E*, RD*, WR*, etc.) allows easy interface to all standard periph- 
eral LSI including 80XX, 68XX and 65XX devices. Example expan- 
sion boards could include a hard disk controller, 1200 baud 
modem, or a LAN interface (SIO, SCC or other LAN chips). 


3.3.8 Power Supply 

The SB180 requires +5V and +12V power. A negative 
voltage is generated on board which is only used by the RS232 
driver. The negative voltage is obtained by using a Zener diode 
to obtain +9V from +12V, which is then inverted using an Intersil 
7660 converter. The +12V pov;er is also only used for the RS232 
driver. Thus, the SB180 only uses significant power from the +5V 
supply. Typically, this may be from 0.8 to 1.5 A (depending on 
the proportion of the TTL and memory devices which are CMOS) - 
about the same as a 5.25" floppy. 
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4.0 


SB180 Monitor 


The SB180 monitor provides commands to assist the design 
and debugging of SB180 related hardware and software. The 
monitor also serves as a stand-alone training vehicle for the 
HD64180 high integration CPU. 


4.1 I/O Devices 

The monitor supports the following I/O 'devices': 

CON: - Console RS-232 serial port 
AUX: - Auxiliary RS-232 serial port 
CEN: - Centronics parallel printer port 
DSK: - Floppy disk storage devices 


4.2 Disk Format 

The monitor supports two disk drive types with the 
following specification: 

5 1/4", 48 TPI, 40 track, double sided, double density 
5 1/4", 96 TPI, 80 track, double sided, double density 

Note that equivalent double sided 3 1/2" drives can also be used. 

During initial system check-out, a 40 track DS/DD drive 
must be connected to verify operation of the disk interface. 
After check-out, different disk drives (as supported by the SB180 
Z-System DOS implementation) can be connected. 

The high capacity format provides 5K bytes per track (10K 
bytes per cylinder) resulting in a formatted capacity of 400K 
bytes and 800K bytes for 40 and 80 track drives respectively. 
Differences in sector sizes between 40 and 80 track formats pro- 
vides a simple method of drive identification. 


4.3 RESET 

The RESET sequence (from power-up or a reset switch) is as 
follows. The monitor first initializes the system and performs 
some diagnostics. Normally (diagnostics OK), the monitor then 
enters a loop waiting for a disk to be loaded in drive #0 or a 
carriage return to be entered from the console. If a disk is 
loaded, the DOS boot routine (same as the 'Z' command) is start- 
ed. If a carriage return is sensed, the baud rate is determined 
(see the following section) and the monitor signs on. 

Two diagnostic failures cause the above sequence to be 
changed. First, if a RAM failure is detected, the monitor waits 
for a carriage return to be entered. In response, a string of 8 
bits will be displayed on the console (last displayed is LSB) . 
Bit positions with a '!' represent bad RAM chips. After the 
display, the monitor HALTS and requires another RESET to restart. 
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Second, if a problem with the SMC 9266 FDC is detected, 
the monitor will wait for a carriage return to be entered. In 
response, the monitor will sign on. However, instead of the 
normal sign-on message, an error message will be printed. 

In either of the above cases the monitor will not try to 
boot a disk, even if the drive is ready. Thus, if a disk doesn't 
J3uaat-.Ji th£i i _..,the sYstenL .J^.&£SLE J _ . enter a carri age r¥€urh'~W~^^^g"tt^ 
diagnosMcs results. 


4.4 Console Baud Rate 

The auto baud rate selection described above requires the 
console baud rate to be either 19200, 9600, 1200, or 300 baud. 
Note that the baud rate auto-sense routine requires a CPU clock 
rate of 6.144 MHz. 

The console should be configured for the following data 

format; 

8 data bits, 1 stop bit, no parity 

Note that the console CTSl* modem control input to the 
HD64180 is grounded by a trace on the board. CTSl* can be 
connected to the console by cutting and jumpering JP4-JP5. If 
so, CTSl* must be asserted by the console, or the system will 
appear inoperative since the monitor will be unable to transmit 
to the console. 


4.5 Console I/O 

The monitor prompt is "n>" where "n" represents the 
currently selected memory bank (see the "B" command). 

Commands consist of a command code, followed by 0 to 4 
parameters and terminated by a carriage return. Parameters are 
separated by a " " or a and leading blanks are ignored. 

Numeric parameters are assumed to be in HEX (with the 
exception of the #-of-tracks parameter for the "K" disk format 
command and the baudrate specifier for the "E" terminal emulation 
command). Leading ''0'"s are ignored. For commands which require 
16 bit parameters, the last four hex digits are recognized. For 
commands which require 8 bit parameters, the last two hex digits 
are recognized. 

Console entry may be upper or lower case. 
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For example, the following command lines have the same 

result. 

0>D 0 F ;Display memory from 0000 to 000F 

0>d 0 f 

0>DO,F 

0>D12340000. 5678000F 
0>D ' 0, F 

4.6 Commands 

The following table is a summary of the monitor commands; 
a complete description of each command follows. 


ASCII Table 
Bank Select 
CopyDisk 
Display Memory 
Emulate Terminal 
Fill Memory 
Goto Program 
Hexmath 
Input Port 
Klean Disk 
Move Memory 
New Command 
Output Port 
Printer Select 
Query Memory 
Read Disk 
Set Memory 
Test System 
Upload Hex File 
Verify Memory 
Write Disk 
Examine CPU Regs 
Yank I/O Regs 
Z-System Boot 


A 

Bbank# (bank# = 0 to 3) 

Csource-drive# destination-drive# 

D [start-addr] [end-addr] 

E [baudrate] 

Fstart-addr end-addr dataS 
G[go-addr] or GB break-addr [go-addr] 
Hdatal6 datal6 
Iport-addr 

Kdrive# #-of-tracks (40 or 80) 
Mstart-addr end-addr destination-addr 
N [command#] (command# = 0-FF hex) 
Oport-addr dataS 
P 

QdataS [dataS] [dataS] [dataS] 

Rdrive# ,dest-addr , start-sect# , #-of-sects 

Sstart-addr 

Tdevice 

U[C] 

Vstart-addr end-addr destination-addr 
Wdr ive# , start-addr , start- sec , #-of-secs 
X 
Y 

Z [drive#] 


Figure 4.6-1 MONITOR COMMAND SUMMARY 
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4.6.1 ASCII Table ~ >A 

Prints an ASCII code table. 


4.6.2 Bank Select - >Bbank# (bank# = 0 to 3) 

Selects a 64K memory bank. The currently selected bank is 
indicated in the command prompt. All commands which reference 
memory operate on the currently selected bank. The bank offset 
is only applied to logical addresses between 2000hex and EFFFhex. 
Addresses 0-lFFFhex always refernce the monitor (based at phys- 
ical address 00000hex) , while addresses F000-FFFFhex always ref- 
erence the monitor data/stack area (physical addresses 4F000- 
4FFFFhex) This memory management scheme allows 56K of banked 
memory with a 4K common area at the bottom of ROM memory and a 4K 
common area at the top of RAM memory. 


4.6.3 CopyDisk - >Csource-dr ive# destination-drive# 

Source-drive# and destination-drive# can take the values 0 
to 3 and correspond to the physical drive address (the jumper on 
the drive) . Systems with 256K bytes RAM can perform single drive 
copies (i.e., C0 0), in which case a "swap disk" prompt will be 
issued. The Copy command requires that both disks be of the same 
type (i.e., 4,0 or 80 track). 


4.6.4 Display Memory - >D [start-addr] [end-addr] 

Displays memory in hex and ASCII. If start-addr is 
omitted, the display will start with the address following the 
last invocation's end address (or address 0 if the first 
invocation). If end-addr is omitted, the display will end 80hex 
bytes following the start address. 


4.6.5 Emulate Terminal - >Etbaudrate] 

Console keyboard input is echoed to the AUX: RS-232 
output, and AUX: RS-232 input is echoed on the console display. 
Baud rate is specified as 150, 300, 600, 1200, 2400, 4800, 9600, 
19200,. or 38400. Note - the baud rate option only works if the 
CPU is operating at the standard (6.144 MHz) clock rate. If you 
have a non-standard clock rate configuration, use the "0" Output 
Port command to directly reprogram the baud rate or modify your 
monitor (EP)ROM (see the monitor ROM modification section). The 
command prompts for a key which will exit the terminal mode and 
return to the monitor. At system start up, the AUX: port is 
initialized to 19200 baud, 8 data bits, 1 stop bit and no parity. 

The AUX: port supports RTS0* modem control output and the 
DCD0* and CTS0* modem control inputs (inputs and output are 
relative to the HD64180). The RTS0* output is . always asserted. 
The CTS0* and DCD0* inputs must be asserted by the connected 
device, or grounded on the board. 


Page 52 



4.6.6 Fill Memory - >Fstart-addr end-addr dataS 

Memory from start-addr to end-addr is filled with dataS (8 
bit data, 0-ffhex) . Care should be taken to avoid writing to the 
monitor program (0-lFFFhex) and stack/data (FF00-FFFFhex) areas. 


4.6.7 Goto Program - >G[go-addr] or GB break-addr [go-addr] 

CPU registers are initialized and program execution 
continues at go-addr. The GB format sets a breakpoint at break- 
addr. If go-addr is omitted, program execution continues at the 
saved PC (see the "X" command) . 


4.6.8 Hexmath - >Hdatal6 datal6 

Prints the 20 bit sum and difference, and the 32 bit 
product of the two arguments. (datal6 is 0-FFFFhex) 


4.6.9 Input Port - >Iport-addr 

Prints the 8 bit data input from port-addr in hex and 

binary. 

4.6.10 Klean (Format) Disk - >Kdrive# #-of-tracks (40 or 80) 

Asks for confirmation and then formats and verifies the 
specified disk. 


4.6.11 Move Memory - >Mstart-addr end-addr destination-addr 

Moves the memory block between start-addr and end-addr to 
destination-addr. Care should be taken to avoid writing to the 
monitor program (0-lFFFhex) and stack/data (FF00-FFFFhex) areas. 


4.6.12 New Command - >N [command#] (command# = 0-FF hex) 

Loads the A register with the command# (0 if no command# 
specified). If an extended (EP)ROM is installed (16KB or 32KB), 
the extended ROM space (2000hex to 4000hex or 8000hex) is en- 
abled. A CALL to address 2000hex is executed. To return to the 
monitor, the new command should terminate with a RET instruction. 
If extended (EP)ROM was enabled, it is disabled upon return. 


4.6.13 Output Port - >Oport-addr dataS 

Data8 byte is output to port-addr. Note that most aspects 
of the HD64180 operation (baud rates, data format, wait states, 
etc.) can be configured by output to chip registers. 
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4.6,14 Printer Select - >P 


Toggles the printer selection between the Centronics par- 
allel port and the Auxiliary serial (RS-232) port. The initial 
value is Centronics. 


4,6.15 Query (Search) Memory - >Qdata8 [dataS] [dataS] [dataS] 

Searches memory for the memory pattern comprised of one to 
four bytes and prints addresses at which the pattern is found. 


4.6,16 Read Disk - >Rdrive#,dest-addr , start-sector#, #-of-sectors 

Reads the specified sectors from drive# into memory at 
dest-addr. The first sector on the disk is "1" and the last sec- 
tor on the disk is 190hex (400 decimal) and 320hex (800 decimal) 
for 40 and 80 track drives, respectively. 


4.6.17 Set Memory - >Sstart-addr 

Displays the memory contents at start-addr and allows new 
data to be entered. Entering carriage return proceeds to the 
next address. Entering terminates the command. 

4.6.18 Test System - >Tdevice 

Tests various system devices. TA specifies the Auxiliary 
serial (RS-232) port which prompts for input or output test. If 
input, serial input is echoed on the console. For input, the 
DCD0* AUX: modem control input must either be asserted by the 
connected device or grounded with the jumper on the board - 
otherwise an error message is printed. If output, a test pattern 
is transmitted. For output, the CTS0* AUX: modem control input 
must either be asserted by the connected device or grounded with 
the jumper on the board - otherwise an error message is printed. 
TC specifies the Centronics parallel port to which a test pattern 
is transmitted. If the printer doesn't respond in a reasonable 
time (approx. 5 seconds) an error message is printed. TD speci- 
fies a disk seek and read (non-destructive) test. If a bad sec- 
tor is found, the disk test is aborted and the contents of the 
9266 status registers (identifying the type of error, track, 
head, sector, etc.) are displayed. If no device is specified, a 
memory test is performed. The memory test is non-destructive and 
v’ill print a after each 256KB pass. 

All tests can be terminated with CTL-X or CTL-C. 
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4.6.19 Upload Hex File - >U [C] 


An Intel format hex file is uploaded. If the [C] option 
is specified, the data is uploaded from the Console serial port, 
otherwise the data is uploaded from the Auxiliary serial port. 
Note that upload termination requires reception of a CTL-X (lA 
hex). Thus, if the PIP command were used to download a .HEX file 
for a CP/M system, the [H] option should be specified. The 
command terminates by printing the address of the last byte 
loaded . 


4.6.20 Verify Memory - >Vstart-addr end-addr destination-addr 

The contents of the memory block from start-addr to end- 
addr is compared with the block at destination-addr. When source 
and destination data differ, the addresses and data values are 
printed. 


4.6.21 Write Disk - >Wdrive#, start-addr , start-sector , #-of-sectors 

Writes the specified sectors to disk from memory at start- 
addr. The first sector on the disk is "1” and the last sector on 
the disk is 190hex (400 decimal) and 320hex (800 decimal) for 40 
and 80 track drives respectively. 


4.6.22 Examine CPU Registers - >X 

Displays the main and alternate CPU registers and prompts 
for modification of the main registers. Entering a carriage re- 
turn proceeds to the next register while entering a termin- 
ates the command. 


4.6.23 Yank I/O Registers - >Y 

Displays the HD64180 on-chip I/O register contents. 


4.6.24 Z-System Boot - >Z [drive#] 

Boots the Z-System DOS (or other suitably configured 
operating system) from the specified drive. 
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4.7 


Error Messages 


4.7.1 FDC Error 

Displayed a.t RESET if the Monitor cannot correctly init- 
ialize the 9266 FDC. This indicates a hardware fault such as a 
bad FDC, bad address decoder, etc. Use the I and 0 commands to 
verify FDC input/output operations. The FDC status port is 80H, 
the data port is 8lH. 


4.7.2 Disk R/W Error 

Following this message, the contents of the 9266 FDC stat- 
us registers are printed along with id information (track, head, 
sector) . Typically, this indicates the disk is not formatted 
correctly (i.e., non-”native” format), but may also result from 
faulty media or hardware. Corrective action includes retrying 
the operation, reformatting the disk, resetting the system., test- 
ing memory, swapping disk drives, etc. 


4.7.3 Disk Seek Error 

Explanation and correction - see above. 


4.7.4 Disk Not Ready 

The drive is not loaded with the door closed and the motor 
on. Check to insure your drive provides a "READY" signal. If 
not, connect the "No Drive Ready" jumper on the board. Check to 
insure your drive responds to the "Motor On" signal. If not, 
either connect the "Motor (always) On" jumper on the board, or 
jumper your drive to achieve the same effect. Note that some 
drives are typically jumpered to enable the stepper and spindle 
motor based on drive select. However, depending on the motor 
control circuit, these drives may not be able to tolerate the 
9266 FDC "Scan" function which toggles drive select at high speed 
when the drive is otherwise idle. In this case, the drive must 
be jumpered so that the motors are always on. 


4.7.5 Bad Command 

An invalid command has been entered. Use the "?" command 
to see a list of available commands and their syntax. 


4.7.6 Bad Parameter 

An invalid parameter has been entered. Remember that most 
commands require hex parameters. Use the "?" command. 
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4.7.7 Not Enough Parameters 

The command requires more parameters than were entered. 
Use the command. 


4.7.8 Invalid Interrupt 

The HD64180 has received an internal or external interrupt 
for which no interrupt handler is provided. The only interrupts 
the HD64180 recognizes are external interrupts INTI* (Centronics 
interface) and INT2* (Disk interface) . External interrupts INT0* 
and NMI* may be shorting to ground. Internal interrupts (DMAC, 
timers, etc.) may be inappropriately enable by a program crash or 
incorrect use of the "0" output port command. 


4.7.9 Bad Opcode Trap 

The HD64180 has encountered an invalid opcode. This may 
be the result of a user program crash - confirm your program. 
This may also occur due to slow or faulty memory - perform a 
memory test. In this regard, note that the HD64180 has stricter 
access time requirements for opcode fetch than other read/write 
cycles and this is not checked by the memory test. Try repro- 
gramming the on-chip wait state generator (DCNTL register, I/O 
address 32hex) or using faster memory chips. 


4.7.10 CTS0* HIGH 

Displayed during the >TA (Test AUX; port) output command 
if the CTS0* modem control input is not LOW at the HD64180. 
Check the connected device and cable. 


4.7.11 DCD0* HIGH 

Displayed during the >TA (Test AUX: port) input ’ command if 
the DCD0* modem control input is not LOW at the HD64180. Check 
the connected device and cable. 


4.7.12 No ACK* 

Displayed during the >TC (Test CEN : port) command if the 
printer does not return ACK* within about 5 seconds after a byte 
is sent to the printer. Check the printer state (on line/off 
line, etc.) and cable. 


4.8 Disk Format 

The monitor "R" and "W" (Read and Write disk) commands 
treat the diskette as containing "virtual" 1KB sectors. Actually 
the format for 40 and 80 track drives is defined as follows: 
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40 Track Double Sided, Double Density 

The disk contains 40 cylinders, each consisting of two 
sides/tracks. Each track is made up of 10 sectors of 512 bytes. 
Thus, total formatted capacity is 512 bytes x 10 sectors x 2 
sides X 40 cylinders = 400K bytes. Sector numbers start at 
llhex, with an interleave factor of two. Actual order on the 
track is (hex) 11, 16, 12, 17, 13, 18, 14, 19, 15, lA. During 
formatting the 9266 FDC GPL (gap length) parameter is 24 decimal, 
while GPL is 14 decimal during normal read/write operation. 

80 Track Double Sided, Double Density 

The disk contains 80 cylinders, each consisting of two 
sides/tracks. Each track is made up of 5 sectors of IK bytes. 
Thus, total formatted capacity is IK bytes x 5 sectors x 2 sides 
X 80 cylinders = 800K bytes. Sector numbers start at llhex, with 
an interleave factor of two. Actual order on the track is (hex) 
11, 14, 12, 15, 13. During formatting the 9266 FDC GPL (gap 
length) parameter is 99 decimal, while GPL is 14 decimal during 
normal read/write operation. 


4.9 Monitor ROM Modification 

The monitor is organized to allow easy modification to 
support non-standard CPU clock rates (standard is 6.144 MHz), 
unique console and auxiliary port baud rates and data formats and 
optimized disk timing parameters. Also the monitor can be ex- 
tended by using 27128 or 27256 devices in conjuction with the "N" 
new command. Never reprogram or erase your original monitor 
EPROM! Instead, read it on another system, save the object file, 
make a copy of the object file, modify that copy, and then burn a 
new (EP)ROM. 


4.10 Key Variable Block 

Nine bytes, located starting at address 35hex, in the 
monitor allow changing a number of operating parameters as 
defined below. 

4.10.1 STARTBYTE - Address 35hex, default value = FFhex 

Normally FFhex, the upper and lower nybbles of STARTBYTE 
control two aspects of the monitor start sequence. 

Changing the upper nybble of STARTBYTE allows disabling 
the console baud rate autosense routine if either a non-standard 
baud rate (i.e., not 300, 1200, 9600 or 19,200) console baud rate 
is required or if a non-standard (6.144 MHz is standard) CPU 
clock is used. In either case, change the upper nybble of START- 
BYTE to 0. Note that STARTBYTE is related to CNTLBl byte (see 
below). If STARTBYTE is not changed (i.e., equals Fx hex to use 
autosense) then CTTLBl default value of 1 must also not be 
changed. 
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Changing the lower nybble of STARTBYTE to 0 allows dis- 
abling the DOS autoboot function so that the monitor will always 
sign on independent of whether a disk is loaded. This is 
especially useful if the "No Drive Ready" jumper is installed on 
the board to prevent hanging in the DOS boot loop if a disk is 
not loaded. 

STARTBY T E Meaning 

FFh Baud rate autosense, DOS autoboot (default value) 

0Fh Fixed baud rate (based on CNTLBl value) , 

DOS autoboot 

F0h Baud rate autosense, DOS autoboot disabled 

00h Fixed baud rate (based on CNTLBl value) , 

DOS autoboot disabled 


4.10.2 CNTLA0 - Address 36hex, default value = 65hex 


Contains the value programmed into the HD64180 CNTLA0 reg- 
ister which defines, among other things, the AUX: port data for- 
mat (i.e., # data bits, stop bits, parity, etc.). The default 
value also asserts RTS0* low. 


4.10.3 CNTLAl - Address 37hex, default value = 75hex 

Contains the value programmed into the HD64180 CNTLAl reg- 
ister which defines, among other things, the CON: port data for- 
mat (i.e., # data bits, stop bits, parity, etc.). 


4.10.4 CNTLB0 - Address 38hex, default value = 1 

Contains the value programmed into the HD64180 CNTLB0 reg- 
ister which defines, among other things, the AUX: port baud rate. 
Note that the "E" emulate terminal command allows the baud rate 
to be set from the console. However, the "E" baud rate function 
only works when the CPU operates at the standard (6.144 MHz) 
clock rate. 


4.10.5 CNTLBl - Address 39hex, default value = 1 

Contains the value programmed into the the HD64180 CNTLBl 
register which defines, among other things, the CON: port baud 
rate. If your console does not operate at the standard baud 
rates (300, 1200, 9600, 19,200 are standard) or the CPU clock is 
non-standard (6.144 MHz is standard) both STARTBYTE (see above) 
and ZCNTLBl must be changed. STARTBYTE must be set to 0 (dis- 
ables the baud rate autosense routine) and CNTLBl set to the 
appropriate value given your console baud rate and CPU clock 
rate. 
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4.10,6 STAT0 - Address 3Bhex, default value = 0 

Contains the value programmed into the HD64180 STAT0 reg- 
ister which enable or disables AUX; port interrupts, which are 
normally disabled. 


4,10.7 STATl - Address 3Chex, default value =4 

Contains the value programmed into the HD64180 STAT0 reg- 
ister which enable or disables CON; port interrupts as well as 
enabling or disabling the CON: port CTSl* modem control input. 
CON: port interrupts should normally be disabled and the default 
value enables the CTSl* function. Thus, CTSl* must be grounded 
on the board (default case) or asserted by the console if con- 
nected. 


4.10,8 DCNTL - Address 3Dhex, default value = 7Chex 

Contains the value programmed into the HD64180 DCNTL reg- 
ister which defines, among other things, the number of memory and 
I/O wait states generated by the HD64180 on-chip wait state gen- 
erator. Normally, the least significant four bits of this value 
should not change since they define DMA parameters associated 
with basic disk operation. Change the upper four bits to account 
for faster or slower CPU clock rate and/or memory-I/0 devices. 


4,10.9 RCR - Address 3Ehex, default value = 82hex 

Contains the value programmed into the HD64180 RCNTL reg- 
ister which defines the interval and duration of HD64180 gener- 
ated DRAM refresh cycles. Normally, this value needs to be 
changed only if the CPU clock rate is reduced below 3.072 MHz. 


4.10,10 SPCFl - Address 3Fhex, default = 9Fhex 

Contains the value used as the first parameter of the 9266 
FDC SPECIFY command which defines the step rate and head unload 
time for the floppy disk drive. This can be changed if your disk 
has higher performance than the conservative default value. Note 
that a DOS BIOS can reSPECIFY in a "soft" manner, so it may be 
wise to leave the conservative default in the ROM to allow for 
easy connection of drives with poor or unknown performance char- 
acteristics. 


4.10,11 SPCF2 - Address 40hex, default value = 28hex 

Contains the value used as the second parameter of the 
9266 FDC SPECIFY command which defines the head load time and 
data mode for the floppy disk drive. As above, this can be 
changed, but change may not be required since the DOS BIOS can 
reSPECIFY. Note, the data mode must be "DMA". 
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4.11 


The "N" NEW Command 


The monitor, which requires 8K bytes of (EP)ROM can co- 
reside with other system software in a larger 16K byte or 32K 
byte (EP)ROM. The extra 8K bytes or 24K bytes can contain 
additional software such as BASIC, Forth, a DOS, or 111 

At RESET, the monitor determines how big the installed 
ROM is. The "N" NEW command can then "phantom" in an extended 
(EP)ROM. Also, an optional parameter on the "N" command line is 
loaded into the Accumulator (A) for passage to the extended rou- 
tines. When the extended routine terminates with a RETurn in- 
struction, the monitor regains control and "phantoms" out the 
extended (EP)ROM to allow access to overlayed RAM. Note that 
this return mechanism requires the extended routine to save the 
return address if it sets up a different stack. Also, the ex- 
tended routine should avoid writing to the physical address area 
4FF00-4FFFFhex since this area contains monitor data structures. 

To implement an extended (EP)ROM simply requires assembl- 
ing your routines to start at the "end" (address 2000hex) of the 
monitor. Developing the code is made easier by the fact that, 
with only the 8K byte monitor installed, the "N" command will 
jump to address 2000hex without performing the "phantom" func- 
tion. After the code is tested in RAM, burn it and the monitor 
in a new {EP)ROM, install it (remember to adjust the ROM size on 
the SB180 system board) , and operation will be exactly the same 
as during debug. 


For further information on the ROM monitor, consult the 
monitor source code on the appropriate system disk. 
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SB180 COMPUTER PG 2 DP 4 (MEMORY) COPYRIGHT 1985, CIARCIA'S CIRCUIT CELLAR 
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SB180 PG 4 DF 4 (PRINTER Sc PS) COPYRIGHT 1985, CIARCIA'S CIRCUIT CELLAR 


6/6/85 








36 Pin CENTRONICS 36 Pin CENTRONICS 
Female Connector Male Connector 


Your Printer 



DB-25S RS-232 


DB-25P RS-232 


Female Connector 


Male Connector 


SB180 Serial Modem Port 
DTE 


Your Modem 



Figure 5.1 Sample Cable Assemblies 
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COMPONENT LIST 


SB180 - SINGLE BOARD 64180 SYSTEM 


CAPACITORS 


RESISTORS 


C1-C8 

. 1 MFD 

50V MONOLITHIC 

R1 


10 

K, 

1/4 W, 5% 


C9 

1 MFD 

25V ELECTROLYTIC 

R2 


4.7 

K, 

1/4 W, 5% 


C10-C15 

. 1 MFD 

50V MONOLITHIC 

R3 


100 

OHM 

, 1/4 W, 5% 


C16 

1500 PFD 

50V MONOLITHIC 

R4 


4.7 

K. 

1/4 W, 5% 


C17,C18 

.1 MFD 

50V MONOLITHIC 

R5 


470 

K, 

1/4 W, 5% 


C19,C20 

27 PFD 

50V MONOLITYIC 

R6 


4.7 

K, 

1/4 W, 5% 


C21-C31 

. 1 MFD 

50V MONOLITHIC 

R7,R8 

1.0 

K, 

1/4 W, 5% 


C32 

.01 MFD 

50V MONOLITHIC 

R9 


4.7 

K, 

1/4 W, 5% 


C33 

. 1 MFD 

50V MONOLITHIC 

R10 


120 

OHM 

, 1/2 W, 5% 


C34 

10 MFD 

25V ELECTROLYTIC 

SIPl 

-SIP3 

4.7K, 9 

ELEMENT, PIN 

1 1 COMMON 

C35 

100 MFD 

25V ELECTROLYTIC 

SIP4 


330 

OHM 

, 7 ELEMENT, 

PIN 1 COMMON 

C36,C37 

10 MFD 

25V ELECTROLYTIC 










MISCELLANEOUS 





DIODES 












J1 


1 X 

2, 

.1 CTR, (HARDWIRE) 

CRl 

1N4148A 

, SIL, FAST SWITCH 

J2-J4 

2 X 

10, 

.1 CTR, ST, 

.230 L 

CR2 

1N4001, 

SIL, BLOCKING 

J5 


2 X 

20, 

.1 CTR, ST, 

. 320 L 

CR3 

1N4739A 

, SIL, ZENER, 9.1V, IW 

J6 

(OPTION) 

1 X 

8, 

.1 CTR, ST, . 

230 L 




J7 


1 X 

4, 

.1 CTR, RT, . 

320 L 




J8 

(OPTION) 

2 X 

25, 

.1 CTR, SHROUDED, ST 

INTEGRATED 

CIRCUITS 


J9 


2 X 

17, 

.1 CTR, SHROUDED, RIGHT 




JPl- 

JP3 (OPT) 

1 X 

3, 

.1 CTR, ST, . 

230 L 

IC1-IC8 

41256, 

DRAM, 256K, (150NS OR 90NS) 

JP4 

(OPTION) 

1 X 

5, 

.1 CTR, ST, . 

230 L 

IC9 

74LS374 

, OCTAL LATCH, TRISTATE 

JP5 

(OPTION) 

1 X 

3, 

.1 CTR, ST, . 

230 L 

U10 

74LS74, 

DLATCH, DUAL 

JP6 

(OPTION) 

1 X 

2, 

.1 CTR, ST, . 

230 L 

U11-U13 

74LS157 

, MUX, QUAD, NONINVERT 

JP7 

(OPTION) 

1 X 

3, 

.1 CTR, ST, . 

230 L 

U14,U15 

74LS74, 

DLATCH, DUAL 

JP8 

(OPTION) 

2 X 

8, 

.1 CTR, ST, . 

230 L 

U16 

ROM, (8K STANDARD) 

JP9 

(OPTION) 

1 X 

3, 

.1 CTR, "ST, . 

230 L 


2764 

8K X 8 OR 

JP10 


1 X 

3(2), "T", .1 CTR, ST, .230 


27128 16K X 8 OR 

JUMPER (2) 

1 X 

2 HEADER JUMPER 



U17 

U18 

U19 

^20 (OPTION) 
U21 
U22 
U23 
U24 
U25 
U26 
U27 
U28 
U29 


27256 32K X 8 

1488, TRANSMITTER, LEVEL SHIFT 
64180, MICROCOMPUTER 

1489, RECEIVER, LEVEL SHIFT 
74LS156, OCTAL DECODE (DUAL 1 OF 4) 
74LS240, HEX INVERT 

74LS00, QUAD NAND 
74LS240, HEX INVERT 
FDC9266, FLOPPY DISK CONTROLLER 
74LS158, QUAD MUX, INVERT 
74LS139, 1 OF 4 DECODE, DUAL 
7407, HEX BUFFER, NONINVERT 
7406, HEX BUFFER, INVERT 
ICL7660, VOLTAGE INVERTER 


PBl 
XTALl 
XTAL2 


SOCKETS 

1 

8 

14 

3 

1 

1 

1 


PUSHBUTTON, (RESET) 
CRYSTAL, 12.2880 MHZ 
CRYSTAL, 8.0000 MHZ 


8 PIN 
14 PIN 
16 PIN 
20 PIN 
28 PIN 
40 PIN 

64 PIN (SHRINK DIP) 
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if ic 


ic 


ic ic 

* Z R D O S * 

* * 

* Version 1.0 * 

ic ic 

* Echelon Z-Systan Disk Operating Syston * 

* * 

* PROGRAMMER'S GUIDE * 

* A 


icicicicicicicicicicicicicicicicicicicicicicicicicicicic 


by 

Dennis L. Wright 
1 January 1985 


ZRDOS, its utilities, and documentation files are Copyright 1984 
and 1985 by Dennis L. Wright and Echelon, Inc. ZCPR3 is 
Copyright 1984 by Richard Conn and Echelon, Inc. CP/M and MP/M 
are registered trademarks of Digital Research. No part of this 
guide may be reproduced in any way or by any means without prior 
written permission from Echelon, Inc. 



ZRDOS is a Z80 coded CP/M 2.2 compatible 
Disk Operating System. Use of Z80 code allows 
addition of many new features. This document 
explains these features and differences between 
ZRDOS Version 1.0 and CP/M 2.2. 



ZRDOS Plus 


ZRDOS PIiDS 


ADDENDDM 

TO ZRDOS VERSI(»I 1.0 PROGRAMMER'S GUIDE 


ZRDOS Plus is the re-entrant version of ZRDOS Version 1.0. 
All features and function calls are identical to those outlined 
in the ZRDOS Version 1.0 Programmer's Guide with the following 
addition . 

Programs that intercept BIOS calls from ZRDOS Plus can be 
written to make calls to ZRDOS without destroying the original 
DOS callers pointers and parameters. 


Re-entrance can be accomplished by first saving the current 
ZRDOS Plus buffers. This is done by copying the ZRDOS Plus 
buffers to a user assigned save buffer area of 147 bytes. Once 
the DOS data has been saved the user program is free to make any 
DOS calls necessary. Before returning to the original DOS 
caller, the ZRDOS Plus buffers must be restored. The beginning 
of the ZRDOS Plus parameter-Buffer area is located at ZRDOS Plus 
base + 5 (ZRDOS Plus base is the address specified in system page 
zero, hex location 06) and is 147 bytes in length. 

The main purpose of making ZRDOS re-entrant is to allow the 
efficient programming of ZCPR3 I/O Packages, packages (modules of 
1.5k-bytes length) that redirect Device Record (Console, List, 
Reader and Punch) input and output to and from disk files. 
Echelon, Inc. offers several lOPs that make use of this feature. 



ZRDOS Plus 


EXAMPLE METBOD OF SAVING AND RESTORING ZRDOS PLUS BUFFERS 


The following routines demonstrate a method that can be used to 
save and restore the ZRDOS Plus buffers to allow re-entrant calls to 
ZRDOS Plus. 

i 

DOS EQU 5 

BUFOFF EQU 5 ; Offset from beginning of ZRD(3S Plus to 

; internal dos buffers. 

r 

; This routine gets the address of the ZRDOS Plus parameter buffer. 

r 

GETBUF: LHLD 06 ; Get dos address. 

LXI D, BUFOFF ; Add offset to ZRDOS Plus internal buffer. 

DAD D 

SHLD DOSBUF ; Save as dosbuf pointer. 


; This routine saves ZRDOS Plus parameters to allow re-entry. 

/ 

SAVDOS: LHLD DOSBUF ; Save ZRDOS Plus parameter buffer. 

LXI D,DOSSAV 

CALL MOV IT 

MVI C,47 ; Function 47 ^ get current dma address. 

CALL DOS 

SHLD CURDMA ; Save it. 

RET 


This routine restores original ZRDOS Ftlus parameters. 


RSTDOS : 

LDED 

CURDMA 

; Restore dma £iddress 


MVI 

C,26 

; Function 26, set drna address. 


CALL 

DOS 



LXI 

H , DOSSAV 

; Restore ZREX3S Pliis parm buffer. 


LDED 

DOSBUF 


MOVIT : 

LXI 

B,147 

; Move 147 bytes. 


LDIR 




RET 



/ 

CURDMA : 

DW 

0 

; Save area for current DMA address. 

DOSBUF : 

DW 

0 

; Sav^e area for pointer to ZRDOS Plus parms. 

DOSSAV : 

DS 

147 

; Save area for ZRDOS Plus parm buffer. 
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1. DIFFERENCES FROM THE STANDARD CP/M CCP 

ZRDOS is a Z80 coded, CP/M 2.2 compatible disk operating 
system designed to be used with Echelon Z80/HD64180 Command 
Processor ZCPR3 written by Richard Conn and auto-install Z3-Dot- 
Cdm by Joseph Wright. 
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1.1. ZCPR3 Utilities and Features 

ZRDOS is compatible with all of the ZCPR3 utilities. Named 
Directories, Redirectable I/O, and all other ZCPR3 features can 
be used with ZRDOS. For installation of these additional 
features please refer to original ZCPR3 documentation package. 
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2. DIFFERENCES FROM CP/M 2.2 BDOS 


2.1. Disk Change 

ZRDOS allows the changing of disks without the need of a 
warm boot. CHANGED DISKS WILL BE AUTOMATICALLY LOGGED IN. 

NOTE: The above mentioned auto login will not occur if a file 

was open when the disk was changed and a write 
operation is attempted to that file on the new diskette 
instead the following error message will be printed: 

Disk Changed Error On Drive B: 

It should also be noted that the automatic logon may or may 
not be able to handle changes in density or number of sides. 
This depends on how your bios handles deblocking and double sided 
disks. However if the disk is of the same density and number of 
sides as the disk it is being swapped with there will be no 
problems . 


2.2. Read Only Disk Status 

Under ZRDOS a disk can only be set to R/O status by 
executing function call 28 (Protect Drive). 


ZRDOS function call 37 (Reset Drive) is different in that it 
will only reset the Read Only bits for the drive(s) specified in 
the user passed drive map in the register pair (DE). With CP/M 
function 37 will also reset the bits for any drive not currently 
active . 

Function call 13 (Reset Disk System) is different in that it 
will not reset drives that are set to Read Only but will instead 
reset the disk changed vector. 


Page 3 



ZRDOS Version 1.0 Prograramer ' s Guide 


2.3. Read Console Buffer 

The Read console buffer routine (Function 10) for ZRDOS is 
different in the following ways: 

o Rubout (DEL) is treated the same as a backspace, 
o The Control -R edit function is not implemented. 

NOTE: In CP/M these are teletype oriented edit commands and were 

felt not to be desired in ZRDOS. 


2.4. File Archiving 

ZRDOS supports the use of the file archive attribute. The 
support of this feature is compatible with both CP/M 3.0 and 
MP/M. This bit when set indicates an archived file. That is a 
file which has not been altered. The bit can be set by using a 
Function 30 (Set File Attributes) function call. Any update to 
this file once the bit has been set will cause the bit to be 
reset. This can then be used by a copy utility to indicate the 
need to backup the file. The utility that backs up the file 
should then set the archive bit to indicate the file has been 
backed up. 


2.5. Wheel Protection 

ZRDOS uses the ZCPR3 wheel byte and a new file attribute bit 
to protect files from non-wheel users. This bit when set will 
write protect the file as long as the wheel byte is off. If the 
wheel byte is set the file is treated as a normal file. 

If a non-wheel user attempts to change a wheel protected 
file the following error message will be displayed: 

A0>File W/P Error on A: 


Page 4 



ZRDOS Version 1.0 Progrcunrner ' s Guide 


2.6. Error Messages 


ZRDOS 

Error 

Number 

1 Read Error On A: 

2 Drive Select Error On A: 

3 Disk R/O Error On A: 

4 File R/O Error On A: 

5 Disk Changed Error On A: 

6 File W/P Error On A: 


CP/M 


Bdos 

Err 

On 

A: Bad Sector 

Bdos 

Err 

On 

A: Select 

Bdos 

Err 

On 

A:R/0 

Bdos 

Err 

On 

A: File R/O 

n/a 




n/a 





With ZRDOS all non-retryable errors jump directly to warm 
boot after the error message has been printed. Read Errors allow 
the user the option of retrying the operation by pressing any key 
but control-c or aborting by pressing control-c. Error numbers 
shown above are returned in the (A) register. The selected drive 
number is returned in register (E). 

NOTE: If the warm boot trap (see FUNCTION 50) is set ZRDOS jumps 

directly to the warm boot vector and no error messages 
are displayed. (User program stack pointer not returned.) 

CP/M handles the errors in the same manner except a key 
must be pressed before CP/M will return from any type of error 
and CP/M doesn't return an error or drive number. Nor does CP/M 
have a warm boot trap function. 
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3. ZRDOS EXTENDED FDNCTI(»I CALLS 


3,1. Function 47: Get Current DMA Address 

This function will return the currently assigned DMA address 
in the register pair (HL). 


3.2. Function 48: Return ZRDOS Version Number 

This function works the same as CP/M function call 12 except 
the ZRDOS Version number is returned instead of the CP/M version 
number. To maintain CP/M compatibility ZRDOS will return version 
number 2.2 on a function 12 call. As with function 12 function 48 
uses the register pair (HL) to return the version number. If user 
programs that use the extended ZRDOS functions are written this 
function should first be used to determine if the program is 
being run under ZRDOS. 


3.3. Function 50: Set Warm Boot Trap 

A new function call is provided that allows the user to set 
a trap on warm boot to a user specified address. The trap is set 
by executing a function 50 call with the trap address in the 
register pair (DE). The Warm boot jump address at location OOIH 
is replaced with the user supplied trap address. Warm boots 
executed after the trap is set will cause a jump to the trap 
address. ZRDOS error messages are suppressed allowing the user to 
print his own error messages. As noted in the ZRDOS error section 
above errors detected by ZRDOS return an error number and the 
active drive number which the user can then use to determine how 
best to handle the error. 

WARNING: Caution should be exercised when using this function as 

the results will be unpredictable if a program that has 
set the trap terminates without first resetting the 
trap. See FUNCTION 52 below. 


3.4. Function 52: Reset Warm Boot Trap 

This new function call will reset the warm boot trap set by 
function call 50. The trap is reset by executing a function call 
52. The Real bios warm boot address is restored to location 
OOOlH. If function call 50 is used in a user program a function 
call 52 should be executed before control is returned to the 
operating system. 


Page 6 



ZRDOS Version 1.0 Prograitmer ' s Guide 


4. ZROOS VERSION 1.0 FDNCTICW CALLS 


FUNCTION 

NUMBER 

DESCRIPTION OF ZRDOS 
OPERATION PERFORMED 

0 

System Reset 

1 

Console Input 

2 

Console Output 

3 

Reader Input 

4 

Punch Output 

5 

List Output 

6 

Direct Console I/O 

7 

Get I/O Byte 

8 

Set I/O Byte 

9 

Print String 

10 

Read console Buffer 

11 

Get Console Status 

12 

Return Version Number (CP/M) 

13 

Reset Disk System 

14 

Select Disk 

15 

Open File 

16 

Close File 

17 

Search For First 

18 

Search For Next 

19 

Delete File 

20 

Read Sequential 

21 

Write Sequential 

22 

Make File 

23 

Rename File 

24 

Return Login Vector 

25 

Return Current Disk 

26 

Set DMA Address 

27 

Get Allocation Vector Address 

28 

Write Protect Disk 

29 

Get Read/Only Vector 

30 

Set File Attributes 

31 

Get Disk Parameter Block Address 

32 

Set /Get User Code 

33 

Read Random 

34 

Write Random 

35 

Compute File Size 

36 

Set Random Record 

37 

Reset Drive 

40 

Write Random With Zero Fill 

47 

Return Current DMA Address 

48 

Return Version number (ZRDOSl) 

50 

Set Warm Boot trap 

52 

Reset Warm Boot trap 


Table 4-1: ZRDOS Version 1.0 Function Calls 
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4.1. FUNCTION 0: SYSTEM RESET 


I Entry Parameters I 

Returned Value ! 

I Register (C) : OOH I 

None 1 


Function to terminate program and reset the system. Same 
results as performing a jump to location OOOOH. The disk system 
is reset; that is disks marked as changed are cleared and the 
directory check information is discarded. 


4.2. FUNCTION 1: CONSOLE INPUT 


1 Entry Parameters 

I Returned Value 1 

1 1 

1 Register (C): OlH 

I Register (A) : ASCII Character ! 


Function to get character from console device. A byte from 
the device currently assigned to CON; is returned in register 
(A). The byte is echoed to the terminal. If no byte is ready at 
the time the call is made, the calling program is suspended until 
a byte becomes available. 


4.3. FUNCTION 2: CONSOLE OUTPUT 


1 Entry Parameters 1 

1 1 

Returned Value 1 

! Register (C) ; OlH ! 

I Register (E): ASCII Character I 

None 1 


Function to output character in register (E) to the device 
currently assigned to CON: and expand tabs if necessary. A 
Control-S (pause) and Control-P (echo to printer) console input 
test is also performed. 
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4.4. FUNCTION 3: READER INPUT 


1 Entry Parameters 

I Returned Value I 

1 i 

I Register (C): 03H 

1 Register (A) ; ASCII Character 1 


Function to get character from the reader device. The next 
byte from the device currently assigned to RDR: is returned in 
register <A). All 8 bits are returned. The calling program is 
suspended until a byte is ready. 


4.5. FUNCTION 4: PUNCH OUTPUT 


1 Entry Parameters ! 

1 1 

Returned Value 1 

1 Register (C); 04H ! 

1 Register <E): ASCII Character ! 

None 1 


Function to output a character to the punch device. The byte 
in register (E) is sent to the device currently assigned to PUN;. 
The program is suspended until the device is ready to accept the 
byte. 
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4.6. FUNCTION 5: LIST OUTPUT 


1 Entry Parameters I 

i 1 

Returned Value 1 

1 Register (C): OSH ! 

1 Register (E): ASCII Character I 

None I 


Function to output a character to the list device. The byte 
in register (E) is sent to the device currently assigned to LST:. 
The program is suspended until the device is ready to accept the 
byte. 


4.7. FUNCTION 6: DIRECT CONSOLE I/O 


1 Entry Parameters 1 

1 1 

Returned Value 

1 

Register (C): 06H 


Register (A): ASCII Char 

Register (E): OFFH 

< input ) 

or 

OFEH 

( status ) 

status 

ASCII Char 

( output ) 



Function to perform direct console i/o. If register (E) 
contains (FF) then this is an input request. If register (E) 
contains (FE> then this is a status request. Otherwise the 
character in register (E) will be sent to the device currently 
assigned to CON:. This request bypasses all control character 
checks . 


Page 10 



ZRDOS Version 1.0 Prograuraner ' s Guide 


4.8. FUNCTION 7: GET I/O BYTE 


I Entry Parameters 

I Returned Value 1 

1 1 

I Register (C): 07H 

I Register (A) : I/O Byte Value I 


Function to return the i/o byte. The current value of the 
lOBYTE (memory location 0003H> is returned in register (A). 


4.9. FUNCTION 8: SET I/O BYTE. 


I Entry Parameters 1 

1 1 

Returned Value ! 

1 1 

I Register (C): 08H 1 

1 Register (E): I/O Byte Value 1 

None 1 


Function to set the i/o byte. The value in (E) is set as the 
current lOBYTE (memory location 0003H). It changes control of the 
output direction immediately. 

The I/O byte located at memory location 0003H is made up of 
the four fields shown in the following table: 


lOBYTE: 

7 6 

1 5 4 

: 3 2 

O 


list 

I punch 

1 reader 

console 

bit value 

(LST: ) 

: (PUN:) 

1 (RDR:) 

( CON : ) 

00 

TTY: 

1 TTY: 

. 

TTY : 

01 

CRT: 

: PTP: 

! PTR: 

CRT: 

10 

LPT: 

1 UPl: 

: URl: 

BAT: 

11 

ULl: 

; UP2: 

: UR2: 

1 UCl: 


Table 

4-2: IC«YTE 

Format 
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4.10. FUNCTION 9: PRINT STRING 


1 Entry Parameters I 

1 1 

Returned Value 1 

1 

1 Register (C): 

I Register (DE): 

1 

09H 1 

String address I 

None 1 


Function to send the character string pointed to by (DE) to 
the device currently assigned to CON:. The printing of the string 
to the console device will continue until a is encountered in 
the string. Console input control character checks are made and 
tabs are expanded. 


4.11. FUNCTION 10: READ CONSOLE BUFFER 


1 Entry Parameters 

I Returned Value ! 

1 1 

1 Register (C): OAH 

I Register (DE): Buffer address 

1 1 

I Console Characters in Buffer 1 

1 1 

I 1 


Function to execute a buffered read. ZRDOS notes the current 
cursor position as it knows it, then reads characters from the 
console device until a CR or LF is received, or until the maximum 
number of characters have been received. 

ZRDOS unlike standard bdos treats the rubout (del) key the 
same as a backspace. Also the control -R function has been 
eliminated. 

The form of the read buffer is as follows: 

BASE = Address in <DE) 

BASE BASE + 1 BASE +2 to end of buffer 

>> 

1 Max # of chars 1 char cnt 1 characters 1 

>> 


Fig. 4-1: Console Buffer Format 
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4.12. FUNCTION 11: GET CONSOLE STATUS 


1 Entry Parameters 

I Returned Value 1 

1 1 

I Register (C) : OBH 

I Register (A) : Console Status 1 


Function to interrogate the console device. The device 
currently assigned to CON: is polled. If a byte is ready for 
input, a nonzero value is returned in register (A), otherwise OOH 
is returned. 


4.13. FUNCTION 12: RETURN VERSION NUMBER 


I Entry Parameters 

1 Returned Value 1 

1 1 

1 Register (C): OCH 

I Register (HL): Version Number 1 


Function to return the current version number. Version 
number 2.2 is returned to maintain CP/M compatibility. Function 
48 should be used to get the ZRDOS version number. 


4.14. FUNCTION 13: RESET DISK SYSTEM 


Entry Parameters 

Returned Value 

Register (C): ODH 

Register (A) : OFFH if the 
current default drive contains 
a file name beginning with a $ 
OOH if not. 


Function to reset the disk system. All active drives are 
reset to an unknown condition. Drive A is relogged in and the DMA 
address is reset to 80H= Unlike CP/M ZRDOS does not reset the 
read only vector of drives that have been set to read only status 
but instead resets the ZRDOS disk changed vector for any drives 
that are marked as changed. 
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4.15. FUNCTION 14: SELECT DISK 


I Entry Parameters ! 

Returned Value 1 

1 Register (C): OEH 1 

1 Register (E): Selected Disk I 

None I 


Function to set the active disk number. Register (E) 
contains a number in the range 0 - 15, signifying disk A - P 
respectively. If the selected drive is not the current default 
drive, it is made the default drive. If it has not been selected 
since the last warm start or disk reset, its directory is scanned 
and new allocation and check vectors are built. 


4.16. FUNCTION 15: OPEN FILE 


1 Entry Parameters 

1 Returned Value 1 

t 1 

1 Register (C): OFH 

1 Register < DE ) : FCB Address 

I Register (A) : Directory Code 1 

1 I 

1 1 


Function to open a specified file. The drive code, if not 
zero, is used to select a drive. The directory is scanned for the 
first match to the filename and extent number in the fcb pointed 
to by the register pair (DE). The filename may contain wildcards. 
A matching directory entry is then copied into the specified fcb 
and register (A) is return with the directory sector location 
code 0-3 (See section on Directory Codes). If no match is found 
register (A) will contain OFFH. 
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4.17. FUNCTION 16: CLOSE FILE 


1 Entry Parameters 

1 Returned Value 1 

1 1 

1 Register (C): lOH 

1 Register (DE): FCB Address 

! Register (A) : Directory Code 1 

1 1 

1 1 


Function to close a specified file. The filename and extent 
number in the fcb pointed to by the register pair (DE) are 
located in the directory. The file name may contain wildcards. If 
they are found, the record count and data map from the specified 
fcb are copied into the directory entry and the directory 
location code 0 - 3 is returned in register (A). If the filename 
can not be found OFFH is returned in register (A). 


4.18. FUNCTION 17: SEARCH FOR FIRST 


1 Entry Parameters 

1 Returned Value 1 

1 1 

1 Register (C): llH 

1 Register (DE): FCB Address 

1 Register (A) : Directory Code I 
( 1 

1 1 


Function to return the first occurrence of a specified file 
name. The directory of the default drive is scanned for an entry 
that matches the filename and extent number in the fcb pointed to 
by the register pair (DE). The filename may contain wildcards. If 
a match is found, the directory location code 0 - 3 is returned 
in register (A). If no match is found OFFH is returned in 
register (A). If the extent number contains OOH, only the first 
extent for a file can be matched. If the extent number contains a 
question mark, the first entry found is returned. If the drive 
number of the specified fcb contains a question mark, all 
directory entries of any user code, and entries of any type 
including those not in use, are compared. 
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4.19. FUNCTION 18: SEARCH FOR NEXT 


I Entry Parameters 

1 Returned Value ! 

1 Register (C): 12H 
! Register (DE): FCB Address 

I Register (A): Directory Code ! 

i I 


Function to return the next occurrence of a file name. This 
function perforins the same as function 17 except that the search 
begins with the entry following the one returned by the last 
search (function 17 or 16). For this function to work correctly 
it roust be proceeded by a search function. 


4.20. FUNCTION 19: DELETE FILE 


! Entry Parameters 

I Returned Value ! 

I Register (C): 13H 

1 Register ( DE ) : FCB Address 

1 Register (A) : Directory Code 1 

i 1 

i i 


Function to delete a file by name. The drive code, if not 
zero, is used to select a drive. The directory is scanned for all 
entries that match the given filename (which may contain 
wildcards). Only files in the active user area are considered. 
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4.21. FUNCTION 20; READ SEQUENTIAL 


I Entry Parameters 

1 Returned Value ! 

1 Register (C): 14H 

I Register (DE) : FCB Address 

1 Register (A) ; Directory Code I 

1 1 


Function to execute a sequential read of the specified 
record number. The drive code, if not zero, is used to select a 
drive. The 128-byte record referenced to by the (cr) byte is read 
and placed into the current file buffer. The (cr) byte is 
incremented. If it then equals the (rc) byte, the entire extent 
has bee read; the directory entry describing the next extent of 
the file is copied into the FCB and (cr< is zeroed. If there are 
no further extents the extent map in the referenced fcb is set to 
zero. If the record is successfully read, register (A) is 
returned containing OOH. If an end of file occurs, register (A) 
is returned containing OFFH. The format of the referenced fcb is 
shown below: 

0 1-89-BC D E F 


dr 1 filename I filetype 1 ex 1 si 1 s2 1 rc 


extent map 


cr 


Fig. 4-2: FCB format 
4.22. FUNCTION 21: WRITE SEQUENTIAL 


I Entry Parameters 

! Returned Value ! 

1 1 

1 Register (C): 15H 

1 Register (DE): FCB Address 

I Register (A) : Directory Code ! 

1 1 

1 1 


Function to write the next sequential record. The drive code 
if not zero, is used to select a drive. If no block has been 
allocated to the record referenced by (cr) of this extent, one is 
allocated and entered in the bit map. The record in the current 
file buffer is written into the position referenced by (cr). The 
FCB bytes (cr) and (rc) are then incremented. If the extent is 
then full, the FCB is copied into the matching directory entry 
and a new entry is made for the next extent, the (cr) and (rc) 
bytes are reset to zero as is the data map area of the FCB. If 
the write was successful, OOH is returned in register (A) 
otherwise a none zero value is returned. 
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4.23. FUNCTION 22: MAKE FILE 


I Entry Parameters - 

1 Returned Value 1 

1 1 

1 Register <C): 16H 

1 Register (DE): FCB Address 

i Register (A): Directory Code 1 

1 1 


Function to create a file. A directory entry is created for 
the filename specified by the fcb pointed to by register pair 
(DE). The newly created entry will contain a pointer to the first 
extent but with no space allocated to it. Upon return register 
(A) will contain the Directory Code for the new fcb if the 
operation was successful or OFFH if no more directory space is 
available. A successfully created file can be treated as open. 


4.24. FUNCTION 23: RENAME FILE 


1 Entry Parameters 

! Returned Value 1 

I 1 

I Register (C): 17H 

1 Register ( DE ) : FCB Address 

! Register (A) ; Directory Code I 

1 t 

1 1 


Function to rename a file. The drive code if not zero, is 
used to select a drive. The directory is scanned and all entries 
for the explicit filename in bytes OlH - OBH of the fcb are 
changed to that in bytes IIH - IBH. If no such directory entry is 
found, OFFH is returned in register (A) else the Directory Code 
is returned in register (A). 
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4.25. FUNCTION 24: RETURN LOGIN VECTOR 


I Entry Parameters 

! Returned 

1 

Value 1 

i Register <C): 18H 

I Register (HL) : 

Login Vector I 


Function to return the login vector. A bit map of the drives 
that are currently active is returned in the (HL). The bits of 
the map stand for drives as follows: 


Register (H) 


Register (L) 


Bit numbers: 
Drive ID: 

Fig. 


76543210 

i I I I I I I I 

I I I I I I I I 

PONMLKJI 


76543210 

I I I t I I I i 

I I I I i I I I 

HGFEDCBA 


4-3: Login Vector Bit Map 


4.26. FUNCTION 25: RETURN CURRENT DISK 


1 Entry Parameters 

1 Returned Value I 

1 1 

1 Register (C): 19H 

I Register (A) : Clurrent Disk 1 


Function to return the current disk assignment. The disk 
number of the currently logged in drive is returned in register 
<A). The number returned ranges from 0 to 15 and corresponds to 
drives A through P respectively. 


4.27. FUNCTION 26: SET DMA ADDRESS 


1 Entry Parameters 

1 Returned 

Value 1 

1 Register (C): lAH 

I Register (DE) : 

DMA Address I 


Function to set the dma address to the address supplied in 
the register pair (DE). The Direct Memory Address used to address 
a 128 byte file buffer for disk read/write transfers is set to 
the address specified in the register pair (DE). The default DMA 
address used by ZRDOS is 0080H. 
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4.28. FUNCTION 27: GET ADDR( ALLOC) 


1 Entry Parameters 

1 Returned 

Value ! 

! Register (C): IBH 

! Register (HL): 

ALLOC Address 1 


Function to return the allocation vector. The address of the 
allocation vector for the currently logged in drive is returned 
in the register pair (HD. 


4.29. FUNCTION 28: WRITE PROTECT DISK 


1 Entry Parameters 

1 Returned Value 1 

I Register ( C ) : ICH 

! None ! 


Function to write protect the current disk. The default 
drive is set to read-only status. Under ZRDOSl unlike CP/M the 
protected drive will retain this status until it is reset with a 
function call 37 or cold boot. 


4.30. FUNCTION 29: GET READ ONLY VECTOR 


1 Entry Parameters 

! Returned Value ! 

1 1 

1 Register ( C ) : IDH 

1 ■' ' " ' • 

! Register (HL): R/O Vector Value 1 


Function to return the read-only status vector. A bit map of 
the drives that are currently marked read-only is returned in the 
(HL). The bits of the map stand for drives as follows: 


Register <H) Register (L> 



Bit numbers: 76543210 76543210 

I f I I I i i I I I I I I I I i 

I I I I I i I I I I I I I I I I 

Drive ID: PONMLKJI HGFEDCBA 


Fig. 4-4: Read Only Vector Bit Map 
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4.31. FUNCTION 30: SET FILE ATTRIBUTES 


I Entry Parameters 

I Returned Value 1 

1 1 

1 Register (C): lEH 
! Register (DE) : FCB Address 

I Register (A) : Directory Code I 

1 1 

1 t 


Function to set the file attributes. The attributes fl-f4 
can be used by the user for any purpose. The next three are 
reserved for future use. Attribute tl is the File Read Only 
attribute and is used to prevent a file from being written to. 
The t2 attribute is the system attribute it alerts the ZCPR3 DIR 
command that this file is not to be displayed. The t3 attribute 
is the file archive attribute and is used to indicate whether a 
file has been updated. Attributes are set by turning on the high 
order bit of the specified byte and reset by turning it off. The 
f8 attribute is the Wheel Protect attribute. If this bit is set 
and the ZCPR3 Wheel byte is off the file can not be written to 
nor can the file's attributes be changed. If the Wheel byte is 
set the file is treated as any other file. 

Attribute User Defined Reserved W/P R/O SYS ARChive 


/ / / / 


Attribute 


I 

• 

fl 

f2 

1 I 

f3 f4 f5 £6 


/ 

f8 

/ 

tl 

/ / 

t2 t3 

FCB Byte No. 

1 0 

1 

1 

2 

3 4 5 6 

7 

8 

: 9 

10 11 1 

1 


Idrv 



filename 



1 1 

1 extension 1 


Fig. 4-5: File Attribute Format. 
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4.32. FUNCTION 31; GET ADDR(DISK FARMS) 


1 Entry Parameters 

1 Returned 

1 

Value 1 

i Register (C): IFH 

1 Register (HL) : 

DPB Address 1 


Function to return the address of the disk parameter block 
for the current drive. The address of the Disk Parameter Block is 
returned in the register pair (HL). 

4.33. FUNCTION 32: SET/GET USER CODE 


Entry Paraimeters 


Returned Value 


Register (C); 20H 
Register (DE): OFFH (get) or 

User Code ( set ) 


Register (A) : Current Code 
or no value 


Function to get or set the user number. If (E) was OFFH then 
this is a request to return the current user number. Else set the 
user number from (E). 
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4.34. FUNCTION 33: READ RANDOM 


I Entry Parameters 

1 Returned Value ! 

1 1 

! Register (C) : 21H 

1 Register (DE>: FCB Address 

1 Register (A) : Return Code ! 

1 1 

1 1 


Function to read a random record from a file. The 'rO', *rl' 
and 'r2' bytes used to construct the fcb pointer to the specified 
record number (see fig. 4-6 on next page). Unlike a sequential 
read operation, the record number is not advanced. Thus, if the 
calling program does not increment the record number subsequent 
random read operations will continue to read the same record. 

As each random read operation automatically sets the extent 
and record values into the specified fcb the file can then be 
sequentially read or written, starting from the currently 
accessed position. 

Upon return from a random read operation register (A) 
contains OOH if the operation was a success or one of the 
following error codes: 

01 - Reading unwritten data 

03 - Cannot close current extent 

04 - Seek to unwritten extent 

06 - Seek past physical end of disk 
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4.35. FUNCTION 34; WRITE RANDOM 


I Entry Parameters 

1 Returned Value ! 

i I 

! Register (C); 21H 

I Register (DE) ; FCB Address 

1 Register (A) ; Return Code 1 

i 1 


Function to write a random record to a file. This operation 
is similar to the Read Random operation, except that data is 
written to the specified record from the currently defined DMA 
address. If the addressed extent or record has not yet been 
allocated, an automatic allocation will be performed before the 
data is written. 

Upon return register (A) contains OOH if the operation was 
successful or an error code if not. The error codes are the same 
as those returned for a Random Read operation with the addition 
of the following code; 

05 - Directory Overflow 


For random R/W, the fcb for the desired record number is set 
per the 'r0,rl,r2' bytes. These bytes in the fcb are used as 
f pi lows; - 

fcb+35 fcb+34 fcb+33 

Byte 


Bit # 


Fig. 4-6: Use of FCB bytes *r0',*rl' and 'r2*. 


r2 

rl 1 

1 

rO 

76543210 

765432101 

1 

7654321 0 


extra I 

1 

i 

overf low 

extent 1 extent 

1 record 


and 's2' I number 

1 

1 ntamber 

1 

1 
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4.36. FUNCTION 35; COMPUTE FILE SIZE 


I Entry Parameters 

1 Returned Value ! 

1 Register (C); 23H 
! Register (DE) ; FCB Address 

1 Random Record Field Set ! 

1 1 

1 1 


Function to compute the size of a random file. The directory 
is scanned to find the highest numbered extent of the filename 
in the fcb specified by register pair <DE). The direct address of 
the specified file's last record, plus one, is set in the record 
address field of the specified fcb. 


4.37. FUNCTION 36; SET RANDOM RECORD 


1 Entry Parameters 

I Returned Value ! 

! Register (C); 24H 
! Register (DE): FCB Address 

1 Random Record Field Set ! 

1 1 

1 1 


Function to return the random record position of a given 
file which has been read in sequential mode up to now. The extent 
number and current record number of the fcb specified by register 
pair (DE) are used to calculate the direct address of the record 
returned by the last sequential read operation. 
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4.38. FUNCTION 37; RESET DRIVE 


1 Entry Parameters 

I Returned Value 1 

I 1 

1 Register (C): 25H 

1 Register (DE): Drive Vector 

1 Register (A) : OOH 1 

1 1 


Function to allow a program to log off any drives. On entry, 
set (DE) to contain a word with bits set for those drives that 
are to be logged off. The log-in vector and the write protect 
vector will be updated. Drives to be reset are specified in the 
register' pair (DE) as follows: 

Register (D) Register (E) 

I I 

I I 


Bit numbers: 76543210 76543210 

I I i I I t I I I I I I I I I I 

I I i I I i I I i I I I I I I I 

Drive ID: PONMLKJI HGFEDCBA 

Fig. 4-7: Active Drive Vector Bit Map. 


NOTE: This function differs from CP/M in that only those drives 

specified in the (DE) will be unprotected and not drives 
which are not currently active as is done in CP/M. 
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4.39. FUNCTION 40: WRITE RANDOM WITH ZERO FILL 


I Entry Parameters 

1 

I Returned Value 1 

1 1 

1 

1 Register (C); 

1 Register ( DE ) : 

28H 

FCB Address 

I Register (A) : Return Code 1 

i 1 

1 1 


Function to write random records with zero fill. When Direct 
Access Write (Function 34) is used to build a file, unwritten 
records within an allocation block contain unpredictable garbage. 
This request fills the unwritten records of each new block with 
binary zeros. 


4.40. FUNCTION 47: RETURN CURRENT DMA ADDRESS 


1 Entry Parameters 

1 Returned Value I 

1 1 

1 Register (C): 2FH 

1 1 

I Register (HL): EMA Address I 


Function to return the current DMA Address. 

4.41. FUNCTION 48: RETURN ZRDOS VERSION NUMBER 


1 Entry Parameters 

I Returned Value I 

1 i 

1 Register (C): 30H 

1 1 

1 Register (HL) : Version number 1 


Function to return the current ZRDOS version number. 
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4.42. FDNCTICtta 50: SET WARM BOOT TRAP 


1 Entry Parameters ! 

Returned Value ! 

! Register (C): 32H 1 

! Register (DE): Trap address ! 

None I 


This function replaces the warm boot jump address at OOOIH 
with a trap address. Warm boots will then be diverted to the trap 
address. 


4.43. FDNCTION 52: RESET WARM BOOT TRAP 


! Entry Parameters 

1 Returned Value I 

1 Register (C): 34H 

! None 1 


Function to reset the warm boot trap. The real warm boot 
address is stored at OOOIH. Warm boots will now be directed to 
the real warm boot. This function will take affect only if the 
warm boot trap was previously set by function 50. 
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5. DIRECTORY CC»ES 


Many of the ZRDOS functions return a directory code as a return 
parameter. The Directory Code is actually a multiplier to be used 
in determining the directory entry location in the default file 
buffer. The default buffer (location BOH) contains 128 bytes (one 
sector) of the directory entries read off of the specified disk. 
There are four 32 byte directory entries to a sector of directory 
information. The returned Directory Code points to one of these 
entries. The specified entry can be found by multiplying the 
Directory Code times 32 and adding this offset to the beginning 
address of the default buffer (BOH). Below is shown a hex ASCII 
image of a typical directory sector loaded into the default 
buffer: 

DEFAULT BUFFER ADDRESS 
/ 


/ 

/ 

/ 


HEX IMAGE 

1 

1 

1 

1 


ASCII 

IMAGE 


/ \ 

0080 

/ 

00444454 

20202020 

20434F4D 

\ 

00000026 

/ 

.DDT 

COM. . 

\ 

.& 

0090 

07000000 

00000000 

00000000 

00000000 



. • 

OOAO 

00454449 

54202020 

20434F4D 

0000004C 

.EDIT 

COM.. 

.L 

OOBO 

OAOBOOOO 

00000000 

00000000 

00000000 



. • 

OOCO 

00474F54 

4F202020 

20434F4D 

00000006 

.GOTO 

COM. . 

• . 

OODO 

91000000 

00000000 

00000000 

00000000 



. • 

OOEO 

0048454C 

4C4F2020 

20202020 

00000009 

.HELLO 

. . 

. . 

OOFO 

3D000000 

00000000 

00000000 

00000000 



. • 


Fig. 5-1: Example Directory Sector. 


The Directory code for the directory entry EDIT.COM is 1. So 
multiplying the directory code by 32 gives us 32 decimal. 32 
decimal is 20 hex. Adding 20 hex to 80 hex gives us AO hex. 
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A 

Allocation Vector, 20 
Archive, 4 
Automatic logon, 3 


BAT:, 11 


CON:, 8, 10, 11, 12, 13 

CP/M BOOS Errors, 5 
CRT: , 11 

Close File, 15 
Compute File Sisse, 25 
Console Input, 8 
Console Output, 8 
Control -C 
•'C, 5 

Control -P 
^P, 8 

Control-R 

-'R, 4, 12 

Control -S 
8 

Current Disk, 19 
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D 

DMA, 13 

DMA Address, 19, 27 

DPB Address, 22 

Delete File, 16 

Direct Console I/O, 10 

Directory Code, 15, 16, 17, 18, 21, 

Disk Change, 3 

Disk Changed Error, 3, 5 

Disk R/O Error, 5 

Drive Select Error, 5 

Drive Vector, 26 


E 

Echo to printer 
'■P, 8 

Error messages, 5, 6 

Error numbers, 5 
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F 

FCB, 14, 15, 16, 17, 18, 21, 23, 24, 25, 

File Archiving, 4 


File R/O 

Error, 5 


File W/P 

Error , 5 


Function 

0: , 

8 


Function 

1: , 

8 


Function 

2:, 

8 


Function 

3:, 

9 


Function 

4:, 

9 


Function 

5:, 

10 


Function 

6:, 

10 


Function 

7:, 

11 


Function 

8:, 

11 


Function 

9:, 

12 


Function 

10:, 

4, 

12 

Function 

11: , 

13 


Function 

12:, 

6, 

13 

Function 

13: , 

3, 

13 

Function 

14:, 

14 


Function 

15:, 

14 


Function 

16:, 

15 


Function 

17:, 

15 


Function 

18:, 

16 


Function 

19:, 

16 


Function 

20:, 

17 


Function 

21:, 

17 


Function 

23: , 

18 


Function 

24:, 

19 


Function 

25:, 

19 


Function 

26:, 

19 


Function 

27:, 

20 


Function 

28: , 

3, 

20 

Function 

29:, 

20 


Function 

30: , 

4, 

21 

Function 

31:, 

22 


Function 

32:, 

22 


Function 

33: , 

23 


Function 

34:, 

24 


Function 

35: , 

25 


Function 

36: , 

25 


Function 

37:, 

3, 

26 

Function 

40:, 

27 


Function 

47:, 

27 


Function 

48:, 

6, 

13 

Function 

50: , 

6, 

28 

Function 

52: , 

6, 

28 


27 
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G 

Get ALLOC Address, 20 

Get Address ( Disk Params ) , 

Get Console Status, 13 

Get DMA, 27 

Get I/O Byte, 11 

Get Read Only Vector, 20 


I 

lOBYTE, 11 


L 

LPT:, 11 
LST:, 10, 11 

List Output, 10 
Login Vector, 19 


N 

Ncuned Directories, 2 
Non-retryable errors , 5 


g 

Open File, 14 


P 

PTP:, 11 
PTR:, 11 
PUN:, 9, 11 

Pause 

''S, 8 

Print String, 12 
Punch Output , 9 


22 
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R 

RDR; , 9, 11 

Read Console Buffer, 4, 12 

Read Error , 5 

Read Only Disk Status, 3 

Read Random, 23 

Read Sequential , 17 

Reader Input, 9 

Redirec table I/O, 2 

Rename File, 18 

Reset Disk System, 3, 13 

Reset Drive, 3, 26 

Reset Warm Boot Trap, 6, 28 

Return Code, 23, 24, 27 

Return Current DMA Address, 27 

Return Current Disk, 19 

Return Login Vector, 19 

Return Version Niimber, 6, 13 

Return ZRDOS Version Number, 6, 

Rubout (DEL), 4, 12 


S 

Search for First, 15 

Search for Next, 16 

Select Disk, 14 

Set ra4A Address, 19 

Set File Attributes, 4, 21 

Set I/O Byte, 11 

Set Random Record, 25 

Set Warm Boot Trap, 5, 6, 28 

Set /Get User Code, 22 

System Reset , 8 


T 

TTY:, 11 


0 

UCl:, 11 
ULl:, 11 
UPl:, 11 
UP2:, 11 

URl:, 11 
UR2:, 11 

User Code, 22 
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Warm Boot Trap, 5, 28 

Warm boot, 5, 6 

Warm boot trap, 6 
Wheel Protection, 4 
Wheel Protection Error, 4 
Wheel byte, 1 
Wildcards, 14, 15, 16 

Write Protect Disk, 3, 20 

Write Random, 24 
Write Random with zero fill. 
Write Sequential , 17 


Z 

ZCPR3, 1, 2, 4 

ZRDOS Errors , 5 
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I. INTRODUCTION 


ZDM, ZDMZ and ZDMH are Z80 and HD64180 machine language debuggers 
and monitors designed to run under Z-System (and CP/M ) operating 
system environment. They recognize and debug 8080, ZOO or 
HD64180 code although they only run on ZOO and HD64180 machines. 
The command types and command structure are nearly identical to 
those of the DDT module provided by Digital Research as part of 
their CP/M operating system. The major difference is that 
Z80/HD64180 code can be debugged and ten new commands with 
variations have been added. ZDM/ZDMZ/ZDMH supports all the DDT 
commands except the in-line assembly command A. Also, only one 
breakpoint is implemented. 

ZDMZ /ZDMH support Zilog Z80 mnemonics whenever instruction 
mnemonics are displayed. Additionally, ZDMH supports the 
enhanced Hitachi instruction set of the HD64180. ZDM uses 
extended Intel 8080 mnemonics similar to TDL (Xitan) which 
retains all standard 8080 mnemonics. Please refer to the 
Appendices for a definition of the mnemonics used by ZDM. Refer 
also to Section III Installation Procedures before attempting to 
run ZDM, ZDMZ or ZDMH. 

Throughout the remainder of this manual all references to 
ZDM apply equally to ZDMZ/ZDMH except where otherwise explicitly 
noted . 

ZDM is invoked by typing one of the following three forms at 
the console; 


ZDM 

ZDM filename 

ZDM f ilename.fi letype 

where "filename" is the name of the file to be loaded. ZDM will 
then sign-on and relocate itself to overlay the CCP and reside 
directly below ZRDOS (or BDOS). The jump to ZRDOS at location 5 
is altered to address the base location of ZDM which, in turn, 
contains a jump to ZRDOS or BDOS. Note that ZDM provides an 
additional page of available transient memory compared to DDT for 
a given size Z or CP/M system. Like DDT, transient programs 
loaded for debugging can overwrite the disassembler module. In 
this case the L command is disabled and the instruction field for 
the X and T commands is replaced by the corresponding hexadecimal 
bytes of the instruction. 

ZDM has an additional feature to prevent overlaying the ZDM 
nucleus itself. If this is about to happen, ZDM aborts the load 
and print an "OUT OF MEMORY" message. It then returns to command 
level so that those portions which were loaded may be examined. 


*CP/M is registered trademark of Digital Research. Z-System is 
trademark of Echelon. 
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The second and third forms of the console command line 
result in the named file being loaded after ZDM is entered. 

After the sign-on message and program loading, if specified 
in the command line, ZDM will respond with the prompt character 
and wait for input commands. Each command consists of either 
one or two characters, as defined in Section II, which determines 
the command type. These characters may also be followed by 
additional parameters. No delimiter should be used between the 
command type characters and the first parameter except as 
described for the G command. Subsequent parameters are delimited 
by a comma or a single space. In all cases, if the command 
expects a final parameter and this parameter is omitted, ZDM will 
assume it is zero. 

All command lines are terminated by a carriage return. All 
keyboard input to ZDM and output from ZDM is in hexadecimal. ZDM 
will accept either upper or lower case letters. A single 
character (?) is printed if an error occurs. To exit ZDM and 
return to ZCPR3 or CP/M command level either a Control-C or a GO 
(jump to loation 0) may be executed. 
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II. ZDM OOMANDS 


Details of each command are given in this Section. 


1. The D (Display) Command. The D command permits the 
operator to view the contents of memory in hexadecimal and ASCII 
formats. The forms are: 

D 

Ds 

Ds,f 

In the first case, memory is displayed from the current 
display address (initially lOOH) and continues for the number of 
lines specified at initialization. Subsequent display addresses 
are initialized to the value of the program counter following an 
X, T, U, or G command. 

The second form of the D command is similar to the first 
except that the display address is first set to address s. The 
third form displays from address s through f. In all cases a 
subsequent issue of the first form will start with the display 
address following the last address displayed, resulting in a 
continuing display. Long typeouts can be aborted with the rubout 
key. 


2. The DI (Disable Interrupt) Command. This command takes 
the single form: 

DI 

The default condition, whenever the target program is entered via 
the G, T, or U command, is that interrupts are enabled. (Inter- 
rupts are always disabled when returning to ZDM). The DI command 
overrides this default condition. The DI command will remain in 
effect until a subsequent El is issued. 


3. The El (Enable Interrupt) Command. This command res- 
tores the default interrupt condition. See the DI command des- 
cription. It takes the single form: 

El 


4. The F (Fill) Command. The F command takes the form: 

Fs,f ,c 

where s is the starting address, f is the final address, and c is 
a hexadecimal byte constant. If c is omitted then it is assumed 
to be zero. This command fills the block of memory from s to f 
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inclusive with the constant c. If f is less than s an error 
message (?) will occur. 


5. The G (Go) Commands. Program execution is started using 
the G command with one optional breakpoint address. The G 
command takes four possible forms: 

G 

Gs 

Gs,b 

G,b 

The first form starts execution of the target program at the 
current value of the program counter and in the current machine 
state with no breakpoints set. The only way for ZDM to regain 
control is through a RST 7 execution. The second form is similar 
to the first except that the program counter is first set to s 
before execution begins. Third form is the same as the second 
except that a breakpoint is set at address b. Program execution 
is stopped and control is returned to ZDM. The instruction at 
address b is not executed when the breakpoint is encountered. 
The fourth form starts execution from the current program counter 
and machine state and sets breakpoint at address b. 

Upon entering a breakpoint, ZDM types *d where d is the stop 
address. The machine state can be examined at this point using 
the X or &X command. 


6. The H (Hex Math) Command. The H command takes the form: 
Ha,b 

where a and b are hexadecimal constants from 1 to 4 digits. The 
sum a+b and the difference a-b are displayed in hexadecimal in 
the form: 


a+b a-b 


7. The I (Input) Command. The I command allows the 
operator to insert a file name into the Z-System default file 
control block at 5CH. The default FCB can be used by the program 
under test as if it had been passed by the Console Command 
Processor. This command must also be used prior to the R command 
when reading additional HEX or COM files. The forms of the I 
command are: 


If ilename 

If ilename.fi letype 

If the filetype is anything except HEX then ZDM will assume 
it is a COM file and the R command will read it into memory 
starting at lOOH. (See the R command for further details). 


Page 4 



ZEM User's Guide 


8. The L (List) Continand. The L cotainand is used to list 
assembly language mnemonics. The three forms of the command are: 

L 

Ls 

Ls , f 

The first form lists the number of lines specified in the 
initialization and starting at the current address of the program 
counter. The second form lists the same number of lines but 
starts at the address s. The third form starts at the address s 
and continues for f lines. All three forms can be continued with 
a subsequent L command similar to the D command. Also, like the 
D command, the starting address if not specified is always 
initialized to the program counter following an X, T, U or G 
command. Long typeouts can be aborted with the rubout key. 

9. The M (Move) Command. The M command will move a block 
of memory from one location to another. The form of the M 
command is: 


Ms,f ,d 


where s is the start address of the move, f is the final address 
and d is the destination address. If f is less than s, an error 
(?) will occur. 


10. The QI (Query Input) Command. The QI command allows 
the operator to read an input port and display the value at the 
port address. The form of this command is: 

QIa 

where a is a one byte port address in hexadecimal. The value is 
printed immediately following execution of this command. Note 
that if a is omitted, it is assumed to be zero. 


11. The QO (Query Output) Command. The QO command allows 
the operator to output a specified byte to a specified port 
address. The form of this command is: 

QOa,b 

where a is the port address and b is the byte to be output. If 
either a or b is omitted, it is assumed to be zero. 
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12. The R (Read) Command. The R command is used in con- 
junction with the I command to read COM and HEX files from disk 
into memory. There are two forms of this command: 

R 

Rb 

where b is an optional offset address which is added to each 
program or data address as it is loaded. If b is omitted then it 
is assumed to be zero. Note that if the file name in the FCB 
from a previous I command is not a HEX type then ZDM assumes it 
is COM and will load it at lOOH or lOOH+b if the parameter b is 
included. If the file cannot be opened or an error occurs in 
reading, ZDM responds with the error indicator (?). Otherwise at 
completion of the load a message is issued: 

NEXT PC 

nnnn pppp 

where nnnn is the next address following the program just loaded 
and pppp is the first address of the program just loaded. For 
HEX files pppp is taken from the last record of the HEX file and 
will be zero unless an END statement followed by the start 
address has been included in the source program prior to 
assembly. 


13. The S (Set) Command. The S command allows memory 
locations to be examined and optionally altered. The form of the 
command is: 


Ss 

where s is the hexadecimal starting address for examination or 
alteration of memory. ZDM will print the address followed by the 
byte stored at that address. A carriage return will advance to 
the next address, displaying the next address and the next byte. 
If a new byte value is typed followed by a carriage return, this 
new value will be stored at that address and ZDM will advance 
automatically to the next address. To terminate the command a 
period is typed rather than a byte value. The command will also 
terminate if an invalid hexadecimal value is entered. 
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14. The T (Trace) Command. The T command permits single 
step instruction tracing of program execution for 1 to 65535 
steps. The forms of this command are: 

T 

Tn 

where n is an optional step number. The first form assumes an 
implied n equal one. The CPU state is displayed and the next 
program step is executed. The termination address is displayed 
as *hhhh where hhhh is the next address to be executed. The 
format for the CPU state display is otherwise identical to that 
of the X command. 

Program tracing is discontinued at the interface to Z-System 
and resumes again after return from Z-System to the target 
program. Long tracing with the Tn command can be stopped with 
the rubout key. ZDM will continue tracing from this break if 
another T or Tn command is issued. 

15. The U (Untrace) Command. The U command is identical to 
the T command except that the CPU state is not displayed. The 
forms of the command are: 

U 

Un 

All conditions of the T command apply to the U command. The last 
CPU state is displayed following the execution of a U or Un 
command . 


16. The X (Examine) Command. (See also the & Command). 
The X command permits selective display and alteration of the 
current CPU state at any time. The forms are: 

X 

Xr 

where r is any of the Z80 registers or flags. 


c 

Carry Flag 

(0/1) 

z 

Zero Flag 

(0/1) 

M 

Minus Flag 

(0/1) 

E 

Even Parity Flag 

(0/1) 

I 

Interdigit Carry 

(0/1) 

A 

Accumulator 

(0-FF) 

B 

BC register pair 

(0-FFFF) 

D 

DE register pair 

(0-FFFF) 

H 

HL register pair 

(0-FFFF) 

S 

Stack Pointer 

(0-FFFF) 

P 

Program Counter 

(0-FFFF) 

X 

X-index register 

(0-FFFF) 

Y 

Y“index register 

(0-FFFF) 
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In the first case the CPU register state is displayed in the 
format 

CfZfMfEflf A=bb B=dddd D=dddd H=dddd P=dddd S=dddd 
X=dddd Y=dddd instruction 

where f is a 0 or 1 flag value, bb is a byte value and dddd is a 
double byte corresponding to a register pair. The instruction 
field contains the disassembled instruction at the location 
addressed by the program counter. 

The second form of the X command permits display and 
optional alteration of register or flag values specified by r. If 
a carriage return is typed following an Xr command then the 

command is terminated with no changes taking place. Otherwise 
ZDM accepts input for register or flag changes. If a hexadecimal 
number in the proper range is typed then that flag or register is 
correspondingly altered. 


17. The & (Alternate Register) Command. The & command 
takes one of three forms: 

& 

&X 

&Xr 

The first form unconditionally exchanges all CPU registers and 
flags to the Z80 alternate register set. 

The second and third forms of this command are identical to 
the X and Xr commands except that the operations take place on 
the alternate register or flag set. Upon termination of these 
latter two forms the CPU state prior to command execution is 
restored. The display associated with the &X command replaces the 
X and Y registers by the vector interrupt register value V. This 
register value may also be altered by an &XV command followed by 
the byte value to be stored in the vector interrupt register. 
The A, B, D and H registers and register pairs are labeled by 
prime (') symbols whenever the alternate set is being displayed 
or altered. ISIote that primes are not used for the flag register 
except during alteration. 

18. The B (Block Search) Command. The B command permits 
the user to search memory for all occurrences of a byte string. 
Strings are limited to ten bytes. A second form of this command 
is initiated by BT rather than B. This second form will accept 
an ASCII or text string. The form of this command is: 

Bs,f or BTs,f 

where s is the start address and f is the final address of the 
memory block to be searched. Following the carriage return you 
will be prompted to enter the string. The B form expects the 
string as a series of HEX bytes. The delimiter may be a space or 
a comma. The BT form expects a single ASCII string. The input 
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string is terminated by a carriage return following the last 
entry. The start address of each occurrence of the string from s 
to f will be displayed. 


19. The V (Verify) Command. The V command will verify if 
two blocks of memory are identical. The form of this command is: 


Vs , f , b 


where s is the start address and f is the final address of one 
block and b is the start address of the other block. If the 

match fails, the address is printed out followed by the byte at 
the corresponding address in the second block. 


20. The P (Print) Command. The P command is a toggle which 
does not expect any arguments. The effect is to send all output 
to the LIST device as well as to the console. It is turned off 
by a subsequent P command. Whenever the P toggle is on, a 'P' 
will be displayed as part of the X or T display. 


21. The J (Jump) Command. The J command is a toggle which 
does not expect any arguments. It only affects siibsequent T or U 
commands. If J has been executed then the T command will display 
only conditional and unconditional CALLS, JUMPS, RETURNS, 
RESTARTS, PCHL (IX or lY) and relative JUMPS. The Tn form of the 
T command is usually used where n represents the actual number of 
instructions to be traced. As usual this command can be aborted 
with the rubout key. Whenever the J toggle is on, a 'J' will be 
displayed as part of the X or T display. 
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III. INSTALLATIC»9 PROCEDURES 


The user should first make a copy of ZDM and keep the 
original master as a back-up. Do not write on the master. Using 
the copy type "ZDM". ZDM will respond with the question "What is 
your terminal width (in hex)". A carriage return in response to 
this question will default to a width of 80(50H). Otherwise, type 
in the character width of your terminal in hex followed by a 
carriage return. Next, the number of lines desired for the D and 
L command displays are requested. A carriage return at^ this 
point defaults to 21{15H) lines. (This is the recommended size 
for 24 line terminals.) Otherwise, type in the number of lines 
desired, in hex, followed by a carriage return. 

Finally, ZDM will ask the question "Is this correct? (Y or 
N)". Do not respond with "Y" at this time. Following an "N" 
response ZDM will sign-on, print the prompt character and 
await a command. You should now test the D and L commands to 
determine if these displays are sized properly for your terminal. 
If not, return to Z-System command level by typing GO or Control- 
C and repeat the above procedure. When you are satisfied that 
the displays are properly sized, then respond with "Y" when asked 
"Is this correct? (Y or N)". After a "Y" response ZDM will 
automatically create your custom installed file. If you are 
using ZDM then the installed file name will be ZDI.COM. If you 
are using ZDMZ or ZDMH then the installed file name is either 
ZDIZ.COM or ZDIH.COM. You may rename these to whatever names you 
desire. 

ZDM is now properly configured for your terminal. 
Subsequent invocations of ZDM will proceed directly to the sign- 
on message. If, at some later time, you wish to change these 
display parameters you will have to start once again with a copy 
of the master uninstalled file. 
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APPENDIX A 


Some users have experienced difficulties with ZDM/ZDMZ when 
used with interrupt driven systems. (ZDMH has interrupts enabled 
as default condition. You can still disable interrupts with the 
DI command when entering the target program but they will be 
enabled again when ZDMH regains control.) The following patches 
are recommended when running ZDM/ZDMZ on such systems. 

Using ZDMH or other debugger, load an image of ZDM/ZDMZ into 
memory starting at lOOh and change the following bytes (addresses 
apply to version 3.2): 


ZDM 

ADDRESS 

ZDMZ 

ADDRESS 

FROM 

TO 

0C61H 

OC31H 

0F3H 

OOH 

0C7AH 

0C4AH 

0F3H 

OOH 

ODCIH 

0D91H 

0F3H 

OOH 


Return to 25-System or CP/M without disturbing the memory image 
and save 22 (or 16h) pages with the SAVE command. 

Another frequent user request has been to change the ZDM 
RESTART address, curently RST 7 at 38h, to a different RESTART. 
The following patches will accomodate this change. (RST 0 cannot 
be used under Z operating system or under CP/M. ) 


ZDM 

ADDRESS 

ZDMZ 

ADDRESS 

ZDMH 

ADDRESS 

FROM 


TO 

0D9DH 

0D6DH 

ODEDH 

38H 

new 

RESTART address 

0DA5H 

0D75H 

0DF5H 

39H 

new 

RESTART address + 1 

1007H 

0FD7H 

1057H 

OFFH 

new 

RESTART opcode 
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APPENDIX B 


The disassembler module of ZDM uses a mnemonic set which is 
similar to the Technical Design Laboratories (TDD mnemonics. 
All Intel 8080 mnemonics are preserved. The Z80 peculiar 
instructions differ from the Zilog mnemonics as shown in the 
accompanying table. The ZDM mnemonic set is nearly identical to 
that released by Digital Research as Z80.LIB to be used with 
their CP/M Macro Assembler "MAC”. The following conventions are 
used in the table. 


r 

rr 

nn 

d 

nnnn 

b 

addr 


- any register or memory 

- any register pair or stack pointer 

- 8 bit immediate data (0 to 255) 

- 8 bit signed displacement (-128 to 127) 

- 16 bit address or immediate data (0 to 65535) 

- bit number (0 to 7, 7 is most significant) 

- 16 bit address within PC+127 through PC-128 


In cases 
last one 

involving a displacement, 
in operand field. 

d, this 

parameter 

is always 

ZDM 

ziuyG 

ZDM 


ZILOG 

LDX r,d 

LD r, (IX+d) 

LDIR 


LDIR 

LDY r,d 

LD r, (lY+d) 

LDD 


LDD 

STX r,d 

LD (IX+d),r 

LDDR 


LDDR 

STY r,d 

LD <IY+d),r 

CCI 


CPI 

MVIX nn,d 

LD (IX+d),nn 

CCIR 


CPIR 

MVIY nn,d 

LD (IY+d),nn 

CCD 


CPD 

LDAI 

LD A, I 

CCDR 


CPDR 

LDAR 

LD A,R 

ADDX 

d 

ADD (IX+d) 

STAI 

LD I, A 

ADDY 

d 

ADD (lY+d) 

STAR 

LD R,A 

ADCX 

d 

ADC (IX+d) 

LXIX nnnn 

LD IX, nnnn 

ADCY 

d 

ADC (lY+d) 

LXIY nnnn 

LD I Y, nnnn 

SUBX 

d 

SUB (IX+d) 

LBCD nnnn 

LD BC , ( nnnn ) 

SUBY 

d 

SUB (lY+d) 

LDED nnnn 

LD DE, (nnnn) 

SBBX 

d 

SBC (IX+d) 

LSPD nnnn 

LD SP , ( nnnn ) 

SBBY 

d 

SBC (lY+d) 

LIXD nnnn 

LD IX, (nnnn) 

ANAX 

d 

AND (IX+d) 

LIYD nnnn 

LD lY, (nnnn) 

ANAY 

d 

AND (lY+d) 

SBCD nnnn 

LD ( nnnn ) , BC 

XRAX 

d 

XOR (IX+d) 

SDED nnnn 

LD ( nnnn ) ,DE 

XRAY 

d 

XOR (lY+d) 

SSPD nnnn 

LD ( nnnn ) , SP 

ORAX 

d 

OR (IX+d) 

SIXD nnnn 

LD ( nnnn ) , IX 

GRAY 

d 

OR (lY+d) 

SI YD nnnn 

LD ( nnnn ) , lY 

CMPX 

d 

CP (IX+d) 

SPIX 

LD SP,IX 

CMPY 

d 

CP (lY+d) 

SPIY 

LD SP,IY 

INRX 

d 

INC (IX+d) 

PUSHIX 

PUSH IX 

INRY 

d 

INC (lY+d) 

PUSFilY 

PUSH lY 

DCRX 

d 

DEC (IX+d) 

POP IX 

POP IX 

DCRY 

d 

DEC (lY+d) 

POPIY 

POP lY 

NEG 


NEG 
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ZDN 

ZIIiOG 

ZDM 

ZIL06 

EXAF 

EX AF,AF' 

IMO 

IM 0 

EXX 

EXX 

IMl 

IM 1 

XTIX 

EX <SP),IX 

IM2 

IM 2 

XTIY 

EX <SP),IY 

DADC rr 

ADC HL,rr 

LDI 

LDI 

DSBC rr 

SBC HL,rr 

DADX rr 

ADD IX, rr 

ODTI 

OUTI 

DADY rr 

ADD IY,rr 

OUTIR 

OTIR 

INXIX 

INC IX 

IND 

IND 

INXIY 

INC lY 

INDR 

INDR 

DCXIX 

DEC IX 

ODTD 

OUTD 

DCXIY 

DEC lY 

OOTDR 

OTDR 

BIT b,r 

BIT b,r 

RLCR r 

RLC r 

SET b,r 

SET b,r 

RLCX d 

RLC (IX+d) 

RES b,r 

RES b,r 

RLCY d 

RLC (lY+d) 

BITX b,d 

BIT b,(IX+d) 

RALR r 

RL r 

BITY b,d 

BIT b,(IY+d) 

RALX d 

RL (IX+d) 

SETX b,d 

SET b,<IX+d) 

RALY d 

RL (lY+d) 

SETY b,d 

SET b,(IY+d) 

RRCR r 

RRC r 

RESX b,d 

RES b,<IX+d) 

RRCX d 

RRC (IX+d) 

RESY b,d 

RES b,(IY+d) 

RRCY d 

RRC (lY+d) 

JR addr 

JR addr 

RARR r 

RR r 

JRC addr 

JR C,addr 

RARX d 

RR (IX+d) 

JRNC addr 

JR NC,addr 

RARY d 

RR (lY+d) 

JRZ addr 

JR Z,addr 

SLAR r 

SLA r 

JRNZ addr 

JR NZ,addr 

SLAX d 

SLA (IX+d) 

DJNZ addr 

DJNZ, addr 

SLAY d 

SLA (lY+d) 

PCIX 

JP (IX) 

SRAR r 

SRA r 

PCIY 

JP (lY) 

SRAX d 

SRA (IX+d) 

RETI 

RETI 

SRAY d 

SRA (lY+d) 

RETN 

RETN 

SRLR r 

SRL r 

INP r 

IN r,(C) 

SRLX d 

SRL (IX+d) 

OUTP r 

OUT <C),r 

SRLY d 

SRL (lY+d) 

INI 

INI 

RLD 

RLD 

INIR 

INIR 

RRD 

RRD 
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APPENDIX C 


HITACHI HD64180 MNQICKIICS 


Object 

Source 


Code 

Statement 

Operation 

ED3805 

INO 

A, (nn) 

Load register with input from 

ED0005 

INO 

B, (nn) 

port ( nn ) . 

ED0805 

INO 

C , ( nn ) 

ED1005 

INO 

D , ( nn ) 


ED1805 

INO 

E, (nn) 


ED2005 

INO 

H , ( nn ) 


ED2805 

INO 

L, ( nn) 




ic'k'A'kit'kiticicit'kicicitiiitieiiciiiciifkitideitieieieic 


ED4C MLT BC Unsigned multiplication of 

ED5C MLT DE each half of the specified 

ED6C MLT HL register pair with the 16-bit 

ED7C MLT ,SP result going to the specified 

register pair. 

ED8B OTDM Load output port (C) with 

location (HL), decrement HL, 

B , and C . 

ED9B OTDMR Load output port (C) with 

location (HL) , decrement HL, 
B, and C. Repeat until B=0. 

'k*ieic'kicicic'kicic'ki(*'k'kick*:kic:k^:kii*i(i(***itic:kic'kicicicic'k‘k'kic9c-k'ki('k*ic’k'kic'ki(ie'k*'k’k*'ki< 

ED83 OTIM Load output port (C) with 

location (HL) , increment HL 
and C. Decrement B. 

'kic:k:kicic'k'k'kicicici(icici(icii'kici(iciciciki(*i<ici(iiticTkitiicii:ii(iici<ificicicici(iciic*icicie^icicicic:k-k*:'k'kiciti( 

ED93 OTIMR Load output port <C) with 

location (HL), increment HL 
and C. Decrement B. Repeat 
until B=0. 


ED3905 

OUTO 

(nn) ,A 

Load output port (nn) from 

ED0105 

OUTO 

( nn ) , B 

register . 

ED0905 

OUTO 

(nn) ,C 


ED1105 

OUTO 

( nn ) , D 


ED1905 

OUTO 

( nn ) , E 


ED2105 

OUTO 

( nn ) , H 


ED2905 

OUTO 

(nn) ,L 




ED76 

SLP 


Enter sleep mode. 


i(:k’kieic-k**ic-kicici<*iicic*:kitic'k:kieic^ic'k’k9ei( 

ED3C 

TST 

A 

Non-destructive AND with 

EDO 4 

TST 

B 

accumulator and specified 

EDOC 

TST 

C 

operand . 

ED14 

TST 

D 


EDIC 

TST 

E 


ED24 

TST 

H 


ED2C 

TST 

L 


ED6405 

TST 

nn 


ED34 

TST 

(HL) 





ED7405 TSTIO nn Non-destructive AND of nn and 

the contents of port ( C ) . 
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APPENDIX D 

ZDM/ZDMZ/ZDMH COMMAND SUMMARY 


Function 

Form 

Definition 

Display 

D[s,f 1 

display screen of memory in hex 
and ASCII 

Disable Interrupt 

DI 

disable interrupts, normal default 

Enable Interrupt 

El 

enable interrupts, default if 
entering from G, T, and U 

Fill 

Fs,f ,c 

fill range of memory with declared 
byte value 

Go 

G[s,b] 

execute program with optional 
breakpoint 

Hex Math 

Ha,b 

obtain sum and difference of two 
hex numbers 

Input 

If ilename 

set up file control block to 
receive file name 

List 

L[s,f ] 

list to screen assembly 
language mnemonics 

Move 

Ms,f ,d 

move data from one area of memory 
to another 

Query Input 

QIa 

display input byte from indicated 
port a 

Query Output 

QOa,b 

output byte b to indicated port a 

Read 

Rib] 

read in file set up with I command, 
optional offset 

Set 

Ss 

examine and optionally alter memory 

Trace 

Tin] 

single step program execution, up 
to 65535 steps 

Untrace 

Uln] 

similar to T, but CPU state 
not displayed 

Examine 

Xlr] 

examine CPU register values 

Alternate Register 

&lX]lr] 

examine Z80 alternate register values 

Block Search 

BlT]s,f 

find ASCII or hex string in 
declared memory range 

Verify 

Vs,f ,b 

verify if two blocks of memory are 
identical 

Print 

P 

send all screen output also to printer 

Jump 

J 

display only branch statements: 
calls, jumps, returns, etc. 


Legend: items in [ ]'s are optional; s=start address; f=final 
address; c^hex byte value; a=hex value or port address; b=hex 
value or offset, breakpoint or block start address; d=destination 
address; n=step number; reregister letter, a for accumulator, b 
for be pair, s for sp, etc. 
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All Rights Reserved 


WARNING 

THIS SOFTWARE AND MANUAL ARE BOTH PROTECTED BY U.S. COPYRIGHT LAW 
(TITLE 17 UNITED STATES CODE). UNAUTHORIZED REPRODUCTION AND/OR 
SALES MAY RESULT IN IMPRISONMENT OF UP TO ONE YEAR AND FINES OF 
UP TO $10,000 (17 use 506). COPYRIGHT INFRINGERS MAY ALSO BE 
SUBJECT TO CIVIL LIABILITY. 


LIMITED WARRANTY 

THIS PROGRAM AND INSTRUCTION MANUAL ARE SOLD "AS IS," WITHOUT 
WARRANTY AS TO THEIR PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR 
ANY PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE RESULTS AND 
PERFORMANCE OF THIS PROGRAM IS ASSUMED BY YOU. 

HOWEVER, TO THE ORIGINAL PURCHASER ONLY, ECHELON WARRANTS THE 
MAGNETC DISKETTE ON WHICH THE PROGRAM IS RECORDED TO BE FREE FROM 
DEFECTS IN MATERIALS AND FAULTY WORKMANSHIP UNDER NORMAL USE FOR 
A PERIOD OF THIRTY DAYS FROM THE DATE OF SHIPMENT. IF DURING 
THIS THIRTY-DAY PERIOD THE DISKETTE SHOULD BECOME DEFECTIVE, IT 
MAY BE RETURNED TO ECHELON FOR A REPLACEMENT WITHOUT CHARGE. 

YOUR SOLE AND EXCLUSIVE REMEDY IN THE EVENT OF A DEFECT IS 
EXPRESSLY LIMITED TO REPLACEMENT OF THE DISKETTE AS PROVIDED 
ABOVE. IF FAILURE OF A DISKETTE HAS RESULTED FROM ACCIDENT OR 
ABUSE ECHELON SHALL HAVE NO RESPONSIBILITY TO REPLACE THE 
DISKETTE UNDER THE TERMS OF THIS LIMITED WARRANTY. 

ANY IMPLIED WARRANTIES RELATING TO THE DISKETTE, INCLUDING ANY 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICU- 
LAR PURPOSE, ARE LIMITED TO A PERIOD OF THIRTY DAYS FROM DATE OF 
SHIPMENT. ECHELON SHALL NOT BE LIABLE FOR INDIRECT, SPECIAL, OR 
CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OF THIS PRODUCT. 
SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDEN- 
TIAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATIONS MIGHT NOT 
APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS, AND 
YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM STATE TO STATE. 


Trademarks: Zas, Zlink, Zlib, Zcon, Zref, Mitek; ZDM, RD 
Software; DSD, Soft Solutions; Z-System, Echelon, Inc.; Z80, 
Zilog, Inc.; HD64180, Hitachi; CP/M, DDT, SID, ZSID, Digital 
Research, Inc. 
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CHM>TER 1 
INTRCHWCTICXI 


1.1 OV]QEIVIEW 

ZAS <Z80 and HD64180 Relocating Macro Assembler) reads assembly 
langtiage statements from a disk file and produces either an Intel 
compatible HEX file or a Microsoft compatible REL file. These 
files can then be loaded using Echelon supplied MLOAD, or CP/M 
LOAD, command or any Microsoft object compatible linker. A 
symbol table file (SYM) is optionally produced that can be used 
with Echelon DSD or Digital Research SID and ZSID debuggers. 

The minimum Z or CP/M system configuration in which to use ZAS is 
48k-bytes of RAM with one disk drive. 

As soon as you receive ZAS, make backup copies! Then go through 
the installation process using a copy. 


1.2 DISTRIBDTICM FILES 

You will find the following files on your distribution disk: 


File 

Function 

ZAS.COM 

Assembler 

ZLINK.COM 

Linker 

ZLIB.CC»1 

Library Manager 

ZCON.COyi 

8080 to Z80 Code Converter 

ZREF.CCM 

Cross-reference Generator 

TEST.Z80 

Test Assembly File 

INSTZAS.COM 

Installation Prograun 


1.3 INSTALLATION 

The installation program was designed to set assembler output op- 
tions. Type in INSTZAS to invoke the installation program. The 
options described on the next page will appear on the screen. 
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INSTZAS<cr> 


ZAS installation options: 

1. Listing to terminal - off 

2. Listing to disk file - off 

3 . Listing to printer - off 

4. Generate object file - on 

5. Generate symbol file - off 

6. Object file type - rel 

7. IF trueness based on - least significant bit 
99. Changes complete 

Enter option number to change: 


The preset values for different options is indicated to right of 
option. To change (toggle) an option value (i.e., on to off, rel 
to hex, or least significant bit to all sixteen bits), simply 
enter option number (1 to 7) followed by carriage return <CR>. 
When desired option changes have been made, type in 99 to end 
installation program and have ZAS.COM automatically updated. 


1.4 SOFTWARE UPDATES 

You can assist in refining ZAS by recommending enhancements and 
reporting any software problems on a copy of the Software Update 
Form, a sample of which is in Appendix B. Software updates will 
be provided at regular intervals for a nominal fee. You will be 
notified by Echelon when software updates are available. 
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CHAPTER 2 
ZAS INVOCATION 


ZAS is invoked by typing; 

ZAS f ilename.f iletype 

where filename is the name of the source file to be assembled. 
If no f iletype is specified, then Z80 is assumed. Typing ''C will 
cancel ZAS operation. 

2.2 ZAS OPTICmS 

A variety of options are available to provide control over the 
execution parameters of ZAS. They are used once at the end of a 
command line and spaces are not allowed between options: 

ZAS filename {$ {options 

There are two types of options; non-disk reference options and 
disk reference options. Using the non-disk reference options 
reverses the settings supplied by the Install Program and in- 
cludes the C, H, and L options. 

C: CRT Option. Setting the C option will page the output of 
ZAS, at 23 lines per page. Pressing any key allows you to 
continue to scroll through the output page by page. However, it 
should be noted that a ''C will abort the assembly. 

H: Hex Option. When this option is set it will generate Intel 
compatible hex files instead of Microsoft compatible REL files. 
Note; When using HEX files, you must have an ORG statement of 
lOOH or higher to prevent an inverted address error from MLOAD or 
LOAD.COM. 

L: Listing to Printer Option. Setting the L option sends a 
formatted assembly listing to Z or CP/M LST: device. 

The disk reference options require two characters. The first 
character is the P, O, or S option characters. The second charac- 
ter indicates the output disk drive for the specified option. 
The second character must be A-P or Z, where Z (for zero or null) 
suppresses the output altogether. 

O: Object File Generation (filename.REL or f ilename.HEX). The O 
option specifies the disk for object file output. Depending on 
the H option, the object file will be a Microsoft compatible REL 
file or an Intel compatible HEX file. 

P; Listing to a PRN File (f ilename.PRN). The P option will send 
a formatted assembly listing to the specified disk. 

S: Symbol File Generation (f ilename.SYM). The S option speci- 
fies output disk for Echelon or DRI compatible SYM file. 
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2.3 ASSEMBLY STATISTICS 

At the completion of an assembly, ZAS provides several statistics 
on the program assembled. The output is as follows: 

Assembly statistics: 

nnnn lines 
nnnn labels 
nnnn macros read 
nnnn macro expansions 
nnnn errors 
nnnn free bytes 

where nnnn is a decimal number. 
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Acceptable program input consists of a sequence of statements in 
the form: 

label operation operand comment 

where each field is separated by one or more spaces and/or tabs. 
All fields are optional and may begin in any column except for 
the label field which must begin in column one. The statement is 
terminated by a carriage return and a line feed is allowed but 
not necessary. You may also insert blank lines into the program. 

The statement may be either upper or lower-case except for macro 
parameters. For macro parameters, the actual and formal parameters 
must be in the same case for substitution to take place. 


3.1 LABEL FIELD 
Labels take the form: 

label or label : 

and are optional except for the SET, EQU, and MACRO assembler 
directives. The label consists of alphanumeric characters, a ?, 
an @, or a $ and the first character must not be numeric. If the 
label exceeds 15 characters then the label is truncated to the 
right. Labels can be either upper-case or lower-case. The 
following a label is optional. Examples of labels include the 
following: 


al23 ?al23 @al23 

aLL: ?ALL: update_file 

All? INDEX UPDATE$FILE 

3.2 OPERATICXl FIELD 

The operation field contains one of the following three: a mne- 
monic machine instruction code, a pseudo operation code which 
directs the assembly process, or a macro. The Z80 mnemonic 
machine instruction codes are listed in Appendix A and Hitachi 
HD64180 instruction codes are listed in Appendix D. The 
assembler pseudo-op codes are discussed in Chapter 5, with a 
summary of the pseudo-ops listed Appendix C. And the macro 
instructions are discussed in Chapter 6. 

3.3 OPERAND FIELD 

The operand field may contain numeric constants, character con- 
stants, ASCII strings, relocation counter references, labels, 
register references, operators, or expressions containing any 
combination of the previously mentioned items. Expressions are 
further described in Chapter 4. 
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3.4 COMMENT FIELD 

A comment field is always preceded by a semicolon <;). Comments 
are ignored by the assembler but are useful for programmer docu- 
mentation, and later, debugging. 



CHAPTER 4 
EXPRESSIONS 


Before the pseudo operations and macros can be described, it is 
necessary to discuss expressions because of their complexity. 
Expressions consist of simple operands combined into properly 
formed sub-expressions by operators. Blanks and tabs are ignored 
between operators and operands of the expression. Each expres- 
sion produces a 16-bit value during the assembly. If only 8 bits 
are needed, the least significant half of the 16-bit value is 
used. 


4.1 NUMERIC CCHISTANTS 

A numeric constant is a 16-bit value in one of several number 
bases. The base, called the radix of the constant, is denoted by 
a trailing radix indicator. Any numeric constant which does not 
terminate with a radix indicator uses the default radix which has 
been initially set to decimal. The radix indicators are: 


B 

O 

Q 

D 

H 


binary constant 
octal constant 
octal constant 
decimal constant 
hexadecimal constant 


base 2 
base 8 
base 8 
base 10 
base 16 


A constant is a sequence of digits, followed by an optional radix 
indicator, where the digits are appropriate for the radix, i.e., 
binary constants must be composed of 0 and 1 digits etc. For 
hexadecimal constants, the leading digit must be a decimal digit 
in order to avoid confusing the hexadecimal constant with an 
identifier (a leading 0 will work). A numeric constant must 
produce a binary number which can be contained within a 16-bit 
value. 


4.2 ASCII STRINGS 

String constants represent sequences of ASCII characters, and are 
represented by enclosing the characters within apostrophe symbols 
('). All strings must be fully contained within the current 
physical line. The apostrophe character itself can be included 
within a string by representing it as a double apostrophe ("), 
which becomes a single apostrophe when read by the assembler. 


4.3 CHARACTER CONSTANTS 

Like strings, character constants are composed of 0, 1, or 2 
ASCII characters, delimited by an apostrophe (') or quotation (") 
symbol. One difference between strings and character constants 
is strings are used only with DB, DC, DEFB, and all macro pseudo- 
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ops. In all other cases, a character constant is assumed. 
Another difference is that the value of a character constant is 
calculated and the result is stored with the low byte in the 
first address and the high byte in the second address. For 
example, in the character constant: 

DW 'AB' 

the value of A is stored in the second memory location and B is 
stored in the first memory location. In the string: 

DB 'AB' 

the value of A is stored in the first memory location and B is 
stored in the second memory location. 


4.4 LABELS 

A label is given a value determined by the type of statement it 
precedes. If the label precedes a macro definition, the label is 
given a text value, which is the body of the macro definition. 
If the label precedes an EQU or SET pseudo operation, then the 
label is given the value of the operand field. If a label 
precedes any other type of statement, it is given the value of 
the current relocation counter. 

The value of a label is not allowed to change unless the label 
precedes a SET pseudo-op. In which case, there is no limit to 
the number of times the label's value may change. 


4.4.1 LABEL CHARACTERISTICS 

Labels fall into one of three categories; public, external, or 
local. Public labels are labels defined in the current program 
module and can be referenced in other program modules External 
labels are labels which have been defined as public in some other 
program module and are being referenced in the module declaring 
them external. If a label has not been declared external or 
public then it is local and cannot be referenced by any other 
program module. 


4.4.2 RELOCATION BASES 

The symbolic names for independently located memory areas are 
called relocation bases. These relocation. bases may represent 
ROM, shared COMMON areas, special memory areas such as video 
refresh, memory mapped I/O, etc. Within each sub-program, each of 
these memory areas is referenced by a unique name. The actual 
allocation and mapping of the name to physical addresses is 
deferred to the link edit and load process. All label references 
within the assembled program are relative to one of these reloca- 
tion bases. The four relocation bases and their typical uses are 
summarized as follows: 
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Absolut:e: Absolute assembles non-relocatable code. A programmer 
selects Absolute mode when a block of program code is to be 
loaded each time into specific addresses, regardless of what else 
is located at the same time. 

Data Relative: Data Relative assembles code for a section of a 
program that may change and therefore roust be loaded into RAM. 
This applies especially to program data areas. Symbols in Data 
Relative are relocatable. 

Code Relative: Code (program) Relative assembles code for 
sections of programs that will not be. changed and therefore can 
be loaded into ROM/PROM. Symbols in Code Relative are 
relocatable. 

COMMON: COMMON assembles code that is loaded into a defined 
common data area. This allows program modules to share a block 
of memory and common values. 

To change the relocation base, use one of the following pseudo- 
ops in a statement line: 

ASEG Absolute 

DSEG Data Relative 

CSEG Code Relative — default 

COMMON COMMON 


4.5 RELOCATICMi OODNTJTO REFERENCE 

The current relocation counter may be referenced as a 16-bit 
value by use of the symbol $. The value represented by $ is 
always the relocation counter value at the start of the current 
statement. For example, 

JP $ 

will endlessly jump to itself. 


4.6 REGISTERS 

When ZAS encounters a one or two character symbol, it will look 
up the symbol in the corresponding 8 or 16-bit register table 
(see the next page). If the symbol is found, then the operand is 
assumed to be a register reference. Because these single and 
double character symbols are reserved words, do not use them as 
labels. 
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8-Bit Registers 16-Bit Registers 
(Reserved Words) (Reserved Words) 

BC 
DE 
HL 
IX 
lY 
SP 
AF 


4.7 OPERATCSIS 

The operands previously described can be combined in normal 
algebraic expression using any combination of properly formed 
operands, operators, and parenthesized expressions. All arithme- 
tic operators ( + ,-,*,/ ,MOD,SHL, and SHR) produce a 16-bit un- 
signed arithmetic result. The relational operators (EQ, LT, LE, 
GT, GE, and NE) produce a true (OFFFFH) or false (OOOOH) 16-bit 
result. And the logical operators (NOT, AND, OR, and XOR) operate 
bit-by-bit on their operand(s> producing a 16-bit result of 16 
individual bit operations. The HIGH and LOW operators always 
produce a 16-bit result with a high order byte which is zero. 
The NUL operator produces a true or false result. 

The operators for the operand field are given below. In general, 
the letters x and y represent operands which are treated as 16- 
bit unsigned quantities in the range 0-65535. 


A 

B 

C 

D 

E 

H 

L 

M 

I 

R 


Arithmetic 

Operators Result 


x+y 

x-y 

X * y 
X / y 
X MOD y 
X SHL y 
X SHR y 


arithmetic sum of x and y 
arithmetic difference between x and y 
unsigned multiplication of x by y 
unsigned division of x by y 
remainder after division of x by y 
shift left by y, with zero right fill 
shift right by y, with zero left fill 


Relational 

Operators 


Result 


X 

EQ 

Yr 

x=y 

true 

if 

X 

X 

LT 

Yr 

x<y 

true 

if 

X 

X 

LE 

Yr 

x< =y 

true 

if 

X 

X 

GT 

Yr 

x>y 

true 

if 

X 

X 

GE 

Y/ 

x>=y 

true 

if 

X 

X 

NE 

Y. 

xOy 

true 

if 

X 


equals y, false otherwise 
is less than y, false otherwise 
is less or equal to y, else false 
is greater than y, false otherwise 
is greater or equal to y, else false 
is not equal to y, false otherwise 
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Logical 

Operators Result 


NOT y 
X AND y 
X OR y» x!y 
X XOR y 


bit-by-bit logical inverse of y 
bitwise logical AND of x and y 
bitwise logical OR of x and y 
logical exclusive OR of x and y 


Special 

Operators Result 


HIGH y 
LOW y 
NUL line 


identical to y SHR 8 (high order byte of y) 
identical to y AND OFFH (low order byte of y) 
true if the remainder of the current line is null 
or contains only space and/or tab characters. Be- 
cause the NUL operator uses the rest of the 
current source line as an operand, it must be the 
last operator on a line. 


4.8 PRECEDENCE OF OPERATCHIS 

Without parentheses or brackets operators have an order of appli- 
cation as if they were parenthesized or bracketed. As described 
below, the operators listed first have highest precedence, and 
the operators listed last have lowest precedence. Operators 
listed on the same line have equal priority and are applied from 
left to right in the expression 


highest precedence 


lowest precedence 


ic 

/ 

MOD 

+ 

SHL 

EQ 

LT 

LE 

GT 


NOT 

AND 


OR XOR 
HIGH LOW 
NUL 


SHR 

GE NE 


The expressions shown below are equivalent: 

x+y*z = x+[y*z] 

X OR y * a SHR b = x OR [y * [a SHR b] ] 

Balanced parenthesized or bracketed sub-expressions can always be 
used to override the order of precedence described above. The 
last expression could be rewritten to force application of opera- 
tors in a different order: 

[x OR y] * [a SHR b] 
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4;9 PAR09THESES VERSUS ESEtAOiETS 

Parentheses arid brackets are not interchangeable. They serve 
different purposes. Parentheses are used in expressions that 
have indirect addressing modes. For example, 

LD HL, (5+1) 

will load the register pair HL from the contents of memory 
location six (5+1) and seven. 

Brackets are used for all other expressions where the addressing 
mode is not indirect. Using the above example with brackets, 

LD HL, [5+1] 

will load the register pair HL with the immediate value six. 


4.10 EXFRESSI(»1 RESTRlCTIC»iS 

The operand field of a statement may consist of a complex arith- 
metic expression with the following restrictions: 

(1) An external may only have an absolute quantity added or 

subtracted from it. The result will be external. 

(2) A relocatable value may have an absolute or another relocat- 
able value (in the same relocation base) added to or sub- 
tracted from it. The result will relocatable. 

(3) If two relocatable values are subtracted then the result will 
be absolute. 

(4) In all other arithmetic and logical operations, both operands 
must be absolute. The result will be absolute. 

An expression error will be generated if an expression does not 

follow the above restrictions. 
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5.1 GENERAL PSEUDO-OPS 

DB: The Define Byte pseudo-op is used to enter one or more one- 

byte data values into the program. The statement form is: 

DB n {/n..*} 

where n is any expression with a valid 8-bit value. More than one 
byte can be defined at a time by separating it from the preceding 
value with a comma. All of the bytes defined in a single DB 
statement are assigned consecutive memory locations. The Zilog 
mnemonic DEFB can be used instead of DB. 

DC: The Define Character pseudo-op stores the characters in a 

string in successive memory locations beginning with the current 
relocation counter. The most significant bit of the last charac- 
ter will be set to one. The form for the DC pseudo-op is: 

DC ' string ' 

DS: The Define Space pseudo-op reserves an area of memory. The 
form is: 

DS expression {, expression} 

where the value of the first expression gives the number of bytes 
to be reserved. The Zilog mnemonic DBFS can be used instead of 
DS. 

To initialize the reserved space, set the optional second expres- 
sion to the value desired. If the second expression is omitted, 
the reserved space is left as is (uninitialized). The reserved 
block of memory is not automatically initialized to zeros. To 
initialize to zeros give the second expression the value 0. 

All names used in the first expression must be previously defined 
on pass 1. Otherwise, a U error (undefined symlxsl) is generated 
during pass 1, and a P error (phase error) will probably be 
generated during pass 2 because the DS pseudo-op generated no 
code on pass 1. 

DW: The Define Word directive is used to enter a 16-bit value 
into the program. This directive takes the form: 

DW nn { , nn . . . } 

Where nn is any expression with a valid 16-bit value. Multiple 
16-bit values may be defined with one DW statement by separating 
the values with a comma. All 16-bit values defined by the DW 
pseudo-op are stored in standard Z80 word format with the least 
significant byte first. The Zilog mnemonic DEFW can be used 
instead of DW. 
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END: The END statement is optional. All statements following the 
END are ignored. The form is: 

END {expression} 

The optional expression is the program starting address. If an 
Intel compatible hex file is being generated, then this starting 
address will be included in the last record of the hex file. If 
a REL file is being generated, then ZLINK will place a JUMP 
instruction at lOOH to the specified starting address. 

EQU: . The EQUa te statement is used to name synonyms for particu- 
lar numeric values. The form is: 

label EQU expression 

The label must be present and cannot label any other statement. 
The assembler evaluates the expression and assigns this value to 
the label. The lalael is usually a name which describes the value 
of the expression. Also, this name can be used throughout the 
program as a parameter or operand. 

.IN: The INsert (or MACLIB) pseudo-op allows the programmer to 
use the same section of assembler source code in a number of 
different assemblies. The format is: 

.IN {d: }filencune or MACLIB {d: }filename 

where d is the optional Z or CP/M disk specifier (defaulting to 
the logged disk) and filename is the file on disk with the 
assumed filetype LIB. 

This directive causes the specified file to be copied into the 
assembly in its entirety, and to be treated exactly as if it were 
part of the original source file. All inserted source lines are 
flagged with a " + " on the listing. Only one level of insert is 
allowed, they cannot be nested. 

.LIST: This pseudo-op resumes a listing which has been suppressed 
by the .XLIST directive. See the next page. 

PAGE: The page pseudo-op gives control over the output formatting 
which is sent to the PRN file and/or directly to Z or CP/M LST: 
device. The form for the PAGE statement is: 

PAGE {expression} 

If the PAGE statement is used without the optional expression 
then a form feed is sent to the output file and/or Z or CP/M LST: 
device. The form feed is sent before the statement with PAGE has 
been printed. Consequently, the PAGE command is often issued 
directly ahead of major sections of an assembly language program, 
such as a group of subroutines, to cause the next statement to 
appear at the top of the following printer page. 

The second form of the PAGE command is used to specify the output 
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page size. In this case, the expression which follows the PAGE 
pseudo-op determines the number of output lines to be printed on 
each page. If the expression equates to a value between 40 and 
90, then the page size is set to the value of the expression. 
When this value is reached for each page, a form feed is issued 
to cause a page eject. The assembler initially assumes a 56 line 
page size and produces a page eject at the beginning of the 

listing. Usually, no more than one PAGE statement with the 
expression option is included in a particular program. 

•RADIX: The statement form is: 

.RADIX n 

where n is 2, 8, 10, or 16. This pseudo-op sets the radix to n 
for all numbers which follow, unless another .RADIX statement is 
encountered, or the radix is overridden by a suffix radix modi- 
fier. Initially, the default radix is set to 10 (decimal). 

SET: The SET statement is used to name synonyms for particular 
numeric values. The form is: 

label SET expression 

The label must be present and cannot label any other statement, 
except for another SET. The assembler evaluates the expression 
and assigns this value to the label. The label is usually a name 
which describes the value of the expression. Also, this name can 
be used throughout the program as a parameter or operand. The 
Zilog mnemonic DEFL can be used instead of SET. 

•TITLE and •SBTTL: The title and subtitle pseudo-ops take the 
form: 


.TITLE 'string-constant 1' 

.SBTTL 'string-constant 2' 

where the string-constants are an ASCII string, enclosed in 
apostrophes, which do not exceed 64 characters. If a .TITLE 
and/or .SBTTL is encountered during the assembly, then each page 
of the listing is prefixed with the title and/or subtitle string- 
constant. The title line will be preceded by a standard ZAS 
header as follows: 

MITEK Relocating Macro Assembler vers n.n page nnn 

string-constant 1 
string-constant 2 

where n.n is the ZAS version number, nnn is the current page 
number and string-constant 1 and/or 2 is the string given in the 
corresponding pseudo-op. ZAS initially assumes that these 
pseudo-ops are not in effect. When specified, the title line, 
along with the subtitle line are not included in the line count 
for the page. Usually, no more than one .TITLE statement is 
included in a particular program. 
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5.2 LISTING CONTROL PSEDDO-OPS 

.LALL: List ALL macro lines, including lines that do not 

generate code. 

.LIST: This pseudo-op resumes a listing which has been 

suppressed by the .XLIST directive. 

.LFCOND: The List False COND itionals pseudo-op assures the list- 
ing of conditional expressions that evaluate false. 

.PRINT: The print on console pseudo-op takes the form: 

.PRINT pass, text 

This pseudo-op will output text to the console during the 
specified pass. The pass can be one of three values; 

0 - print text during both passes 

1 - print text during pass one 

2 - print text during pass two 

.SALL: Suppress ALL of the macro listing, including all text and 

object code produced by macros. 

.SFCOND: The S^uppress False COND itionals pseudo-op suppresses 
the portion of the listing that contains conditional expressions 
that evaluate false. 

.XALL: The Exclude ALL non-code macro lines pseudo-op will list 
source and object code produced by a macro, but source lines 
which do not generate code are not listed. 

.XLIST: This pseudo-op suppresses all list output until a .LIST 
pseudo-op is encountered. 

5.3 CCaiDITICXiAL ASSEMBLY PSEDDO-OPS 

The next two sections describe the ZAS conditional assembly 
facility. 

5.3.1 IF PSEDDO-OP EVALUATION 

ZAS has two different methods for evaluating the trueness of an 
IF expression. One method bases the trueness on the least signi- 
ficant bit of the IF expression, which is compatible with Digital 
Research's ASM, MAC, and RMAC assemblers. The second method 
bases the trueness of the expression on the full 16-bit expres- 
sion value. This method is compatible with the Microsoft M80 
assembler. 
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The default evaluation is set by the installation program 
(section 1.3). The evaluation method may also be explicitly set 
by the following two pseudo-ops: 

.IFl - will cause IF expressions to evaluate to true if 
the least significant bit of the IF expression 
evaluates to 1. 

OR 

.IF16 - will cause IF expressions to evaluate to true when 

the IF expression evaluates to non-zero. 


5.3.2 CONDITICHSAL ASSEMBLY FCffiMS 

The IF, ELSE, and ENDIF pseudo-ops define a range of assembly 
language statements which are to be included or excluded during 
the assembly process. The IF and ENDIF statements alone can be 
used to bound a group of statements to be conditionally 
assembled thus: 

IF expression 

statement #1 
statement #2 


statement #n 
ENDIF 

Upon encountering the IF statement, the assembler evaluates the 
expression following the IF (all operands in the expression must 
be defined ahead of the IF statement). Depending on the condi- 
tional assembly option in effect, if the expression evaluates to 
a non-zero value or the least significant bit evaluates to a 1, 
then statement #1 through statement #n are assembled. If the 
expression evaluates to a zero, then the statements are listed 
but not assembled. 

The ELSE statement can be used as an alternative to an IF 
statement, and must occur between the IF and ENDIF statements. 
The form is: 

IF expression 
statement #1 
statement #2 


statement #n 
ELSE 

statement #n+l 
statement #n+2 


statement #m 
ENDIF 
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If the expression produces a non-zero (true) value, then 
statements 1 through n are assembled. However, statements n+1 
through m are skipped in the assembly process. When the expres- 
sion produces a zero value (false), statements 1 through n are 
skipped, while statements n+1 through m are assembled. As an 
example, the conditional assembly shown in Listing A could be 
rewritten as shown in Listing B. 


Listinc 


TTY 

EQU 

1 


CRT 

EQU 

2 


DEVICE 

EQU 

TTY 


TTYOUT 

EQU 

0F003H 


CRTODT 

EQU 

OFIOOH 



IF 

CALL 

ENDIF 

DEVICE 

TTYOUT 

EQ 


IF 

CALL 

ENDIF 

DEVICE 

CUTOUT 

EQ 



Listim 

a_B 

TTY 

EQU 

1 

CRT 

EQU 

2 

DEVICE 

EQU 

TTY 

TTYOUT 

EQU 

0F003H 

CRTOUT 

EQU 

OFIOOH 


IF 

DEVICE EQ 


CALL 

ELSE 

TTYOUT 


CALL 

ENDIF 

CRTOUT 


TTY 

CRT 


TTY 


Properly balanced IP's, ELSE's, and ENDIF's can be completely 
contained within the boundaries of outer encompassing conditional 
assembly groups. The structure outlined below shows properly 
nested IF, ELSE, and ENDIF statements; 


IF exp#l 

group #1 
IF exp#2 

group# 2 
ELSE 
group# 3 
ENDIF 
group## 

ELSE 

group# 5 

IF exp#3 

group#6 

ENDIF 

group#? 

ENDIF 
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where group 1 through 7 are sequences of statements to be 
conditionally assembled, and exp#l through exp#3 are expressions 
which control the conditional assembly. If exp#l is true, then 
grouptl and group#4 are always assembled, and group 5,6, and 7 
will be skipped. Further, if exp#l and exp#2 are both true, then 
group#2 will also be included in the assembly, otherwise group#3 
will be included. If exp#l produced a false value, groups 1, 2, 
3, and 4 will be skipped, and group 5 and 7 will always be 
assembled. If under these circumstances, exp#3 is true then 
group#6 will also be included with 5 and 7, otherwise it will be 
skipped in the assembly. 

Conditional assembly of this sort can be nested up to eight 
levels (i.e., there can be up to eight pending IFs or ELSEs with 
unresolved ENDIFs at any point in the assembly), but usually 
becomes unreadable after two or three levels of nesting. The 
nesting level restriction also holds for pending IFs and ELSEs 
during macro evaluation. Nesting level overflow will produce an 
error during assembly. 


5.4 LINKAGE PSEDDO-OPS 

EXTRN: The EXT eRNal pseudo-op identifies symbols which are de- 
fined in some other program but are used in the current program. 
The form is: 


EXTRN symbol { , symbol . . . } 

where symbol is the symbol being declared as external. Multiple 
symbols may be declared in the same statement by separating them 
with commas. Also, if a symbol in an expression is suffixed with 
one or two # signs, then the symbol is treated as an external. 
EXT is a synonym for EXTRN. 

NAME: The NAME pseudo-op takes the form: 

NAME symbol 

where symbol is the relocatable module name. This name is used 
by the linking loader and library manager to identify the module 
for selective loading or manipulation. Only the first six 
characters are significant in the module name. In the absence of 
the NAME pseudo-op, up to the first six characters of the program 
name are used. 

PUBLIC: The PUBLIC pseudo-op identifies those symbols within the 
current program which are to be made accessible to other programs 
as external symbols. This directive has no effect on the 
assembly process for the current program, but merely records the 
name and value of the identified symbols on the object file for 
later use by the linking loader. A public symbol must be defined 
within the current program as a label. 
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.REQUEST: Request a library search. The form is: 

.REQUEST filenaitte { ,f ilencume. . . } 

This pseudo-op sends a request to ZLINK or any Microsoft 
compatible loader to search the filenames in the list for 
undefined external symbols. The filename in the list should not 
include filetypes or device designation. ZLINK assumes the 
default extension .REL and the currently logged disk drive. 

5.5 RELOCATI(»I BASE PSEODO-OPS 

ASE6: The Absolute SEGm ent pseudo-op never has operands. ASEG 
generates non-relocatable code. 

ASEG sets the location counter to an absolute segment (actual 
address) of memory. The ASEG will default to 0, which could 
cause the module to write over part of the operating system. It 
is recommended that each ASEG be followed with an ORG statement 
set at lOOH or higher. 

COMMON: COMMON statements are non-executable, storage allocating 
statements. COMMON assigns variables, arrays, and data to a 
storage area called COMMON storage. This allows various program 
modules to share the same storage area. The length of a COMMON 
area is the number of bytes required to contain the variables, 
arrays, and data declared in the COMMON block, which ends when 
another relocation base pseudo-op is encountered. 

CSE6: The Code SEG ment directive never has an operand. Code 
assembled in Code Relative mode can be loaded into ROM/PROM. 

CSEG resets the location counter to the code relative segment of 
memory. The location will be that of the last CSEG (default to 
0), unless an ORG is done after the CSEG to change the location. 

However the ORG statement does not set a hard absolute address 
under CSEG mode. An ORG statement under CSEG causes the assem- 
bler to add the number of bytes specified by the expression 
argument in the ORG statement to the last CSEG address loaded. 
For example, if ORG 25 is given, 25 bytes will be added to the 
current CSEG location. Then CSEG will be loaded. The clearing 
effect of the ORG statement following CSEG (and DSEG) can be used 
to give the module an offset. Rationale for not allowing ORG to 
set an absolute address for CSEG is to keep the CSEG relocatable. 


CSEG is the default mode of the assembler. Assembly begins with 
a CSEG automatically executed, and the location counter in the 
Code Relative mode, pointing to location 0 in the Code Relative 
segment of memory. All subsequent instructions will be assembled 
into the Code Relative segment of memory until ASEG, DSEG, or 
COMMON is executed. CSEG is then entered to return the assembler 
to Code Relative mode, at which point the location counter 
returns to the next free location in the Code Relative segment. 
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DSEG: The D^ata SEG ment pseudo-op never has operands. DSEG 

specifies segments of assembled relocatable code that will later 
be loaded into RAM only. 

DSEG sets the location counter to the Data Relative segment of 
memory. The location of the data relative counter will be that 
of the last DSEG (default is 0), unless an ORG is done after the 
DSEG to change the location. However, the ORG statement does not 
set a hard absolute address under DSEG mode. An ORG statement 
under DSEG causes the assembler to add the number of bytes 
specified by the expression in the ORG statement to the last DSEG 
address loaded. For example, if ORG 25 is given, 25 bytes will 
be added to the last DSEG address loaded. Then the DSEG will be 
loaded. The clearing effect of the ORG statement following DSEG 
(and CSEG) can be used to give the module an offset. Rational 
for not allowing ORG to set an absolute address for DSEG is to 
keep the DSEG relocatable. 

ORG: The Set ORG in pseudo-op allows the value of a location 
counter to be changed at any time. The form is: 

ORG expression 

Under the ASEG program counter mode, the relocation counter is 
set to the value of the expression, and the assembler assigns 
generated code starting with that value. Under CSEG, DSEG, and 
COMMON relocation bases, the location counter for that base is 
incremented by the value of the expression. All names used in 
the expression roust be known on pass 1, and the value must either 
be absolute or in the same relocation base as the current 
location counter. 

.PHASE/. DEPHASE: The form is: 

.PHASE expression 


.DEPHASE 

where expression is an absolute value. .PHASE allows code to be 
located in one area, but executed at a different area with a 
start address specified by expression. .DPHASE is used to 
indicate the end of the relocated block of code. 

The relocation base within a .PHASE block is absolute, the same 
as the mode of the expression in the .PHASE statement. The code, 
however, is loaded in the area in effect when the .PHASE state- 
ment is encountered. The code within the block is later moved to 
the address specified by expression for execution. 
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This example. 





.PHASE 

300H 




CALL 

DUMMY 




JP 

ENTRY 



DUMMY; 

RET 





.DEPHASE 




ENTRY: 

JP 

0 

assembles to: 




0300 



.PHASE 

300H 

0300 

CD0630 


CALL 

DUMMY 

0303 

C30700 


JP 

ENTRY 

0306 

C9 

DUMMY: 

RET 


0007 



.DEPHASE 


0007 

C30000 

ENTRY: 

JP 

0 


5.6 MACRO PSEODO-OPS 

Provided here is only a brief description of the macro pseudo- 
ops. For a more complete description, see the next chapter. 


Pseudo-op 

Description 

ENDM 

End Macro 

EXITM 

E^it Macro 

IRP 

Indefinite Repeat 

IRPC 

Indefinite Repeat Character 

LOCAL 

Local Symbol Generation 

REPT 

Repeat 

MACRO 

Macro Definition 


5.7 SPECIAL FUNCTIOI PSEODO-OPS 

.HD64: This pseudo-op enables ZAS to assemble the ten extended 
instructions of the Hitachi HD64180 microprocessor, upward Z80 
compatible. The ten instructions and their forms are listed in 
A^^ndix D. 
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A common characteristic of assembly language programs is that 
many coding sequences are repeated over and over with only one or 
two of the operands changing. Macros provide a mechanism for 
generating the repeated sequences with a single statement. The 
repeated sequences are written with dummy values for the changing 
operands. A single statement, referring to the macro by name and 
providing values for the dummy operands, can then generate the 
repeated sequence. 

The coding sequence begins with either the macro definition 
pseudo-op or one of the repeat pseudo'-ops and ends with the ENDM 
pseudo-op. All of the macro pseudo-ops may be used inside a 
macro sequence. The one exception is a stored macro which, 
cannot be defined inside a repeat type macro. Macro nesting is 
allowed up to 15 levels deep. 

The macro facility includes pseudo-ops for-: 


macro definition: 

MACRO (macro definition) 

repetitions 

KEPT ( repeat ) 

IRP (indefinite repeat) 

IRPC (indefinite repeat character) 

terminations : 

ENDM (end macro) 

EXITM (exit macro) 

unique symbols within macro sequences: 
LOCAL 

operators: 

& 


% 

<> 


6.1 REPEAT ((Ml INLINE) MACROS 

The simplest macro facilities involve the REPT, IRPC, and IRP 
macro groups. All these forms cause the assembler to repetitive- 
ly re-read portions of the source program under control of a 
counter or list of textual substitutions. These groups are 
listed in increasing order of complexity. 
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REPT-ENDM GROUP: The REPT-ENDM group is written as a sequence of 
assembly language statements starting with the REPT pseudo-op and 
terminated by an ENDM pseudo-op. The form is: 

label : REPT expression 


label : ENDM 

where the labels are optional, and the expression indicates the 
number of times the sequence of statements between REPT and ENDM 
will be repeated. The expression is evaluated as a 16-bit 
unsigned number. If the expression contains an external symbol 
or undefined operands, an error is generated. 

In general, if a label appears on the REPT statement, its value 
is the first machine code address which follows. This REPT label 
is not re-read on each repetition of the loop. The optional 
label on the ENDM is re-read on each iteration and thus constant 
labels (not generated through concatenation or with LOCAL pseudo- 
ops) will generate phase errors if the repetition count is 
greater than 1. 

IRPC-ENDM GROUP: Similar to the REPT group, the IRPC-ENDM group 
causes the assembler to re-read a bounded set of statements. The 
form is: 

label: IRPC identifier, string 


label: ENDM 

where the optional labels follow the same conventions as in the 
REPT-ENDM group. The identifier is any valid symbol and string 
denotes a string of characters, terminated by a delimiter (space, 
tab, end-of-line, or comment). 

The sequence of statements between IRPC and ENDM are repeated 
once for each character in the string. Each repetition 
substitutes the next character in the string for every occurrence 
of identifier in the sequence. 

IRP-ENDM GROUP: The IRP is similar in function to the IRPC, 
except that the controlling identifier can talce on a multiple 
string value. The form is: 

label: IRP identifier, string {, string...} 


label: ENDM 

where the optional labels follow the conventions of the REPT and 
IRPC groups. The sequence of statements between IRP and ENDM is 
repeated for each string. On the first iteration, the string is 
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substituted for the identifier wherever the identifier occurs in 
the sequence of statements. On the second iteration, the second 
string becomes the value of the controlling identifier and so on 
until the last string is encountered and processed. 


6.2 STCHUSD MACROS 

MACRO DEFINITION: The form for the macro definition is: 


roacname MACRO dummy I , dummy ... } 


ENDM 

The sequence of statements from the MACRO statement line to the 
ENDM statement line comprises the body of the macro, or the 
macro's definition. The macname is any non-conflicting assembly 
language label. Dummy parameter is a place holder that is re- 
placed by an actual parameter in a one for one text substitution 
when the MACRO sequence is used. 

The prototype statements are read and stored in the assembler's 
internal tables under the name given by "macname", but are not 
processed until the macro is expanded. 

A comment preceded by two semicolons is not saved as part of the 
macro definition. But a comment preceded by only one semicolon 
is preserved and will appear in the expansion. 


6.3 EXITING MACROS 

The EXITM pseudo-op is used inside a MACRO or Repeat block to 
terminate an expansion when some condition makes the remaining 
expansion unnecessary or undesirable. Usually, EXITM is used in 
conjunction with a conditional pseudo-op. 

The expansion is exited immediately when an EXITM is assembled. 
Any remaining expansion or repetition is not generated. If the 
block containing the EXITM is nested within another block, the 
outer level continues to be expanded. 

6.4 LOCAL SYMBOLS 

The LOCAL pseudo-op is allowed only inside a MACRO definition. 
The form for the LOCAL directive is: 

LOCAL identifier {, identifier ... } 

When LOCAL is executed, ZAS creates a unique symbol for each 
identifier and substitutes that symbol for each occurrence of the 
identifier in the expansion. These unique symbols are usually 
used to define a label within a macro. This eliminates multiple- 
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defined labels on successive expansions of the macro. The 
symbols created by ZAS range from ??0001 to ??9999. Users should 
avoid the form ??nnnn for their own symbols. A LOCAL statement 
must precede all other types of statements in the macro 
definition. 


6.5 MACRO INVOCATICM* 

The form for the macro invocation is; 

macncunne parameter parameter. .. } 

Upon recognition of the raacname, ZAS "pairs-off" each dummy 
parameter in the MACRO definition with the actual parameter text, 
i.e., the first dummy parameter is associated with the first 
actual parameter, the second dummy is associated with the second 
actual, and so on until the list is completed. If more actuals 
are provided than dummy parameters then the extras are ignored. 
If fewer actuals are provided, then the extra dummy parameter are 
associated with the empty string, i.e., a text string of zero 
length. It is important to realize at this point that the value 
of dummy parameter is not a numeric value, but is instead a 
textual value consisting of a sequence of zero or more ASCII 
characters . 


6.6 PMIAMETER EVALDATICM 

There are several options available in the construction of actual 
parameters, as well as in the specification of character lists 
for the IRP group. Although an actual parameter is simply a 
sequence of characters placed between parameter delimiters, these 
options allow overrides where delimiter characters themselves 
become a part of the text. In general, a parameter x occurs in 
the context; 

label ; macname . . . , x , . . . 

where the label is optional and the macname is the name of a 
previously defined macro. The ellipses (...) represent optional 
surrounding actual parameters in the invocation of macname. In 
the case of an IRP group, the occurrence of a character list x 
would be; 

label; IRP id, ...,x,.. . 

where the label is optional, and the ellipses represent optional 
surrounding character lists for substitution within the IRP group 
where the controlling identifier "id” is found. In either Case, 
the statements could be contained within the scope of a sur- 
rounding macro expansion. Therefore, dummy parameter substitu- 
tion could take place for the encompassing macro while the actual 
parameter is being scanned. 

ZAS follows these steps in forming an actual parameter or 
character list; 


Page 26 



CHAPTER 6; MACRO FACILITY 


(1) Leading blanks and tabs are removed when they occur in front 
of X. 

(2) The leading character of x is examined to determine the type 
of scan operation which is to take place. 

<3) If the leading character is a string quote, then x becomes 
the text up through and including the balancing string quote, 
using the normal string scanning rules: double apostrophes 
within the string are reduced to a single apostrophe, and 
upper case dummy parameters adjacent to the ampersand symbol 
are substituted by their actual parameter values. Note that 
the string quotes on either end of the string are included in 
the actual parameter text. 

(4) If instead the first character is the left caret <<) then the 
bracket is removed, and the value of x becomes the sequence 
of characters up to , but not including, the balancing right 
caret (>) which does not become part of x. In this case, left 
and right carets may be nested to any level within x, and 
only the outer carets are removed in the evaluation. Quoted 
strings within the carets are allowed, and substitution 
within these strings follows the rules stated in (3) above. 
Note that left and right carets within quoted strings become 
a part of the string, and are not counted in the caret 
nesting within x. Further, the delimiter characters comma, 
blank, semicolon, and tab, become a part of x when they occur 
within the caret nesting. 

(5) If the leading character is a %, then the sequence of 
characters which follows is taken as an expression which is 
evaluated immediately as a 16-bit value. The resulting value 
is converted to a decimal number and treated as an ASCII 
sequence of digits, with left zero suppression <0-65535). 

(6) If the leading character is none of the above (quote, left 
bracket, or percent), the sequence of characters which 
follow, up to the next comma, blank, tab, or semicolon, 
becomes the value of x. 

There is one important exception to the above rule: the single 
character escape, denoted by an up-arrow, causes ZAS to read the 
character immediately following as a part of x without treating 
the character as significant. However, the character which fol- 
lows the up-arrow, must be a blank, tab, or visible ASCII charac- 
ter. The up-arrow itself can be represented by two up-arrows in 
succession. If the up-arrow directly precedes a dummy parameter, 
then the up-arrow is removed and the dummy parameter is not 
replaced by its actual parameter value. Thus, the up-arrow can 
be used to prevent evaluation of dummy parameters within the 
macro body. Note that the up-arrow has no special significance 
within string quotes, and is simply included as a part of the 
string. 

Evaluation of dummy parameters in macro expansions must also be 
considered, although this topic has been presented throughout the 
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previous sections. Generally the macro assembler evaluated dummy 
parameters as follows: 

(1) If a dummy parameter is either preceded or followed by the 

concatenation operator <&), then the preceding and/or 
following operator is removed, the actual parameter is 

substituted for the dummy parameter, and the implied 
delimiter is removed at the position(s) the ampersand occurs. 

(2) Dummy parameters are replaced only once at each occurrence as 
the encompassing macro expands. This prevents the "infinite 
substitution" which would occur if a dummy parameter eval- 
uated itself. 

In summary, parameter evaluation follows these rules: 

- leading and trailing tabs and blanks are removed 

- quoted strings are passed with their string quotes intact 

- nested carets enclose arbitrary characters with delimiters 

- a leading % causes immediate numeric evaluation 

- an up-arrow passes a special character as a literal value 

- an up-arrow prevents evaluation of a dummy parameter 

- the "&" operator is removed next to a dunrniy parcimeter 

- dummy parameters are replaced only once at each occurrence 
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There are two types of error messages: Non-fatal errors and fatal 
errors. Non-fatal errors are indicated by a single letter code 
to the left of the statement line with the error. Fatal errors 
kill the assembly and give messages as to why the error may have 
occurred. Statement lines with errors will not generate object 
code. 


7.1 NON-FATAL ERRORS 


Error Code 


Explanation 


A 


Argument error. One of the arguments for the op- 
code is invalid. 


B Balance error. An ELSE or an ENDIF pseudo^^op does 

not have a preceding IF statement. Or an END 
macro statement has no preceding macro call and/or 
macro definition. 

C Character is invalid. ZAS has found an invalid 

character and it is probably a control character. 
The invalid character will be replaced by a 

D Duplicate error. A label has been defined more 

than once. 


E Expression error. The expression is ill-formed 

and cannot be computed. 

I Insert error. The specified insert file cannot be 

found or an insert is already in progress. 

M Mode error. The statement contains an addressing 

mode error. 

O Opcode error. The statement contains an illegal 

opcode . 

P Phase error. A label has a different valiie on 

Pass 2 than it did on Pass 1. 


S Syntax error. The assembly statement is ill- 

formed and cannot be processed. This error may 
be due to invalid characters or delimiters which 
are out of place. 

U Undefined symbol. A label argument has not been 

defined in the program. 

V Value error. The operand (argument) is out of its 

allowable range. 
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7.2 FATAI. ERRCmS 

Fatal error messages have been classified into two categories; 
errors caused by macros and general errors (or errors not caused 
by macros). 


7.2.1 GEBIERAL FATAL E^^OR MESSAGES 

(1) "Filename. filetype not found." 

The specified source file cannot be found on the disk. 

(2) "Invalid caption specification." 

One or more of the assembler options specified in the command 
line is invalid. 

(3) "More than eight IF levels are pei^ing at line nnnn" 

Where line nnnn is the line with the ninth IF. A maximum of 
eight IF levels can be nested. 

(4) "Dnterminated IFl" 

The end of file has been reached with no terminating ENDIF. 

(5) "Jtonory full at line nnnn" 

The assembler's internal tables have run out of memory. 


7.2.2 MACRO FATAL ERROR MESSAGES 

(1) "Onterminated macro starting at line nnnn" 

Where line nnnn is the line with the error. This error is 
caused by a macro definition that has no terminating END 
macro statement. 

(2) "Local label limit exceeded!" 

The maximum of 9,999 local symbols has been exceeded. 

(3) "Macro nested past 16 levels at line nnnn" 

A maximum of 16 levels of nested macros are allowed. 

(4) "Local table exceeds 127 bytes at line nnnn" 

The total length of all local symbols cannot exceed 127 bytes 
for a particular macro definition. 

(5) "Macro definition inside an inline macro at line nnnn” 

This message indicates that a macro definition has been 
placed inside a repeat type macro and that is not allowed. 
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CROSS-REFERENCE GENERATION 


8.1 OVERVIEW 

The cross-reference generator (ZREF) is used to provide a summary 
of symbol usage throughout a program. ZREF reads the file speci- 
fied line by line, attaches a line number prefix to each line, 
and writes each prefixed line to the file filename. XRF. After 
completing this operation, ZREF appends to the file f ilename.XRF, 
a cross-reference report that lists all the line numbers where 
each symbol in the file appears. It also flags with an *, each 
line number where the referenced symbol is defined. 


8.2 ZREF OPERATICWI 

ZREF is invoked by typing 

ZREF f ilename.f iletype {$ {option 

where f ilename.f iletype is the name of the file to be cross- 
referenced with the assumed filetype .Z80, and option is the 
letter L, if the output is to the list device instead of a file. 


8.3 RESERVED SYMBOLS 

The following symbols will not be part of the cross reference: 


A 

HI 

NUL 

AF 

HL 

NOT 

AND 

I 

NZ 

B 

IX 

OR 

BC 

lY 

P 

C 

L 

PE 

D 

LE 

PO 

DE 

LOW 

R 

E 

LT 

SHL 

T^r\ 

M 

SHR 

GE 

mu 

SP 

GT 

NC 

XOR 

H 

NE 

Z 
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(mPTER 9 
GCH)E CCXIVERTER 


9.1 CXM)E CCWTVERTER OPERATICMJ 

The code converter (ZCON) converts 8080 source statements, all of 
the TDL machine instruction statements, and most of the common 
TDL pseudo-ops to Z80 source statements (see the next section for 
a listing of the convertible TDL pseudo-ops). In addition, 
except for character-constants, ASCII strings, and comments, 
parentheses are converted to brackets. Also, parity bit (bit 7) 
is zeroed. 

To invoke the code converter, type: 

ZCON filename. filetype {$}u 

where filename is the name of the source file to be converted. 
If no filetype is specified, then ASM is assumed. When the "u" 
option is specified, only upper-case conversion is done. This is 
useful if you already have a Z80 source file in lower case. When 
the conversion is completed, the output will be in a file called 
filename. Z80 and one of two messages will be displayed. 


Message 1: 

"nnnn lines converted, with no errors detected." 
Where nnnn is the number of lines converted. 


OR 


Message 2: 

"nnnn lines converted, with eee errors logged in filename.ERR" 
Where nnnn is the number of lines converted and eee is the 
number of errors detected. 


9.2 CCH4VERTIBLE TDL PSEUDO-OPS 

The code converter will convert 
They include the following: 


.ASCII 

.BLKB 

.BLKW 

.BYTE 

.EXTERN 


the most common TDL pseudo-ops. 


. IDENT 
. INTERN 
.LIST 
.WORD 
.XLIST 
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9.3 ERROR MESSAGES 

If the code converter detects an error in a statement line, it 
leaves the line unchanged. There are two types of error messages. 

(1) "*** Syntax error at line nnn, line follows ***" 

error line 

Where nnn is the statement line number, and error line is the 
statement line with the syntax error. Normally, this error 
should not occur because it indicates that the operand for 
this particular op-code is syntactically incorrect. 

(2) "*** IF/ENDIF unbalanced ***" 

This error message appears if the IFs and ENDIFs are not 
paired. For every IF, there should be an ENDIF, and vice 
versa . 
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10.1 OVERVIEW 

The Z80 Linker (ZLINK) is used to combine Microsoft relocatable 
object modules into an absolute file ready for execution under Z 
or CP/M. When completed, ZLINK lists the sorted symbol table, 
any unresolved or duplicate symbols, and a load map which shows 
the number of free bytes left and the size and locations of the 
different segments: 


LOAD MAP FOR FILENAME . CCM 

SEGMENT SIZE START STOP 

ABSOLUTE 

CODE 

DATA 

COMMON 

FREE 

ZLINK writes the sorted symbol table to a .SYM file suitable for 
use with Echelon Dynamic Screen Debugger (DSD) and Digital 
Research Symbolic Instruction Debuggers (SID and ZSID) as 
described in the S option (see next page). ZLINK also creates a 
COM file for direct execution under Z or CP/M. If errors are 
detected, the P option (see next page) will be set automatically. 


10.2 ZLINK OPERATION 

ZLINK is invoked by typing 

ZLINK filenamelf ,filenaroe2, . . . ,filenameN} 

where filename is the name of the object module(s) to be linked. 
If no filetype is specified, then REL is assumed. If some other 
filename is desired for the COM and SYM files, it may be 
specified as follows: 

ZLINK newf ilename=f ilenamel { ,f ilename2 , . . .f ilenameN} 

If ZLINK encounters a starting address which is caused by sup- 
plying an optional program starting address to the assembler END 
pseudo-op then ZLINK will place a JUMP instruction at lOOH to the 
program starting address. 


10.3 ZLINK OPTKMJS 

A variety of options are available to provide control over the 
execution parameters of ZLINK. Except for the / option (library 
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search option) all of the options are link control options. They 
are used once at the end of a command line: 

filenamell ,f ilename2,...filenameN} $Cnnnn,Dnnnn,P,Rnnnn 

Where nnnn is a hexadecimal number. 


ZLINK options include: 

C: Code Segment Origin Option. The C- option is used to specify 
the load address of the code segment. If it is not used, then 
ZLINK will put the code segment at the address (lOOH). Unless 
the R option indicates otherwise, the relocation value of the 
code segment will be set to its load address. The syntax for the 
C option is Cnnnn, where nnnn if the desired code origin in hex. 

D: Data Origin Option. The D option indicates the load address 
of the data and common segments, if the D option is used, the 
address specified must be higher than the load address for the 
code segment. If it is not used, ZLINK will put the data and 
common segments immediately after the program segment. The syn- 
tax for the D option is Dnnnn, where nnnn is the desired data 
origin in hex. 

P: Paging Option. The P option will page the output of ZLINK, 
at 23 lines per page to the terminal. Pressing any key allows 
you to continue to output one page at a time. 

R: Relocate Origin Option. The R option specifies the re- 
location value for the code segment. If not used, then ZLINK 
will set the relocation value of the code segment to its load 
address . 

S: .SYM File Option. If this option is set, ZLINK will write 
the sorted symbol table to a .SYM file suitable for use with the 
Echelon DSD or Digital Research SID and ZSID debuggers. 

/: Search Option. This option is used to indicate that the pre- 
ceding file should be treated as a library. ZLINK will search 
the file and include only those modules containing symbols which 
are referenced but not defined in the modules already linked. 
Unlike the link control options which can be used once at the end 
of a command line, the / option must be used after each filename 
to be searched: 

filenaittel/ ,f ilename2/ , . . .f ilenameN/ 


10.4 DEFINE NEXT EREE MEMCXIY LOCATICXSt 

If the public symbol $MEMRY is encountered during the link pro- 
cess, then the two bytes addressed by the value $MEMRY and $MEMRY 
+ 1 are filled in with the address of the next free memory 
location. The statement labeled $MEMRy must be a DS statement. 


Page 36 



CHAPTER 10: LINKER 


For example: 

PDBLIC 

FREBEG: LD 

RET 

$MEMRY: DS 


FREBEG, $MEMRY 

HL,($MEMRY) ;This routine returns 

;the first free byte 
2 ; of memory 


10.5 ZLINK ERROR MESSAGES 


<1) "Can't find filename. filetype" 

Specified file cannot be found on the disk. 

(2) "Filename. filetype is an invalid REL filei" 

One of the files specified is not a Microsoft compatible REL 
file. 

(3) "Invalid option specification!" 

One of the options specified is invalid. 

(4) "Memory full!" 

There is insufficient memory to complete the linking process. 

<5) "Undefined symbols:" 

The symbol name(s) following this heading are referenced but 
not defined in any of the modules being linked. 

(6) "Duplicate symbols;" 

The symbol name(s) following this heading are defined as a 
PUBLIC symbol in more than one of the modules being linked. 

<7) "** *Over lapping segments***" 

ZLINK attempted to write a segment into memory already used 
by another segment. This error is probably caused by incor- 
rect use of the C and/or D options. 

( 8 ) "Read error ! " 

A file cannot be read properly. 

(9) "Syntax error in ccmmand line!" 

The command line is ill formed. 

(10) "Multiple main modules!" 

Two or more modules contain a program starting address. 

(11) "Library search limit exceedcjd!" 

A maximum of ten libraries can be specified from assembler 
.REQUEST statements. 
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11.1 CWERVIEW 

The Library Manager (ZLIB) is used to combine Microsoft relocat- 
able object modules into a library. Libraries are files consis- 
ting of any number of relocatable object modules. ZLIB can 
delete modules from a library, concatenate REL files into a 
library, re-place modules in a library, and print module names 
and public symbols from a library. 


11.2 ZLIB OPERATION 

ZLIB is invoked by typing: 

ZLIB libname=f ilenamei , filename, ... } $option 

where libname is the name of the library with filetype REL and 
filename is the name of the object module(s). If no filetype is 
specified, then REL is assumed. 

An alternate form of invoking ZLIB when using the M or P option 
(as described below) is: 


ZLIB libname $listoption 
where listoption is the M or P option. 


11.3 ZLIB OPTICMJS 

If no option is specified, then the specified modules will be 
appended to the library. The options include: 

D: Delete the specified modules. 

M: Print the module names in the library. 

P: Print the module names and public symbols in the library. 

R: Replace the specified modules. 


11.4 ZLIB MESSAGES 

Under the following circumstances ZLIB will produce messages. 
(1) When a module is being appended to the library: 

"i^ppending filename. filetype" 
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<2) If the specified library does not exist on disk and the spec- 
ified option is append: 

"Creating library" 

(3) If a module is being deleted: 

"Deleting modulename" 

(4) If a module is being replaced: 

"Deleting modulename 
j^:pending filename. filetype" 

11.5 ZLIB ERIKMR MESSAGES 

(1) "Can’t find filename. filetype" 

Specified file cannot be found on the disk. 

(2) "Filename. filetype is an invalid REL filei" 

One of the files specified is not a Microsoft compatible REL 
file. 

(3) "Invalid option specification!" 

The option specified is invalid. 

(4) "Syntax error in ccwmand line!" 

The command line is ill formed. 
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APPENDIX A 

Z80 MNEMONIC MACHINE INSTRUCTION CODES 


Object 


Source 



Code 


Statement 

Operation 

Notes 

8E 

ADC 

A, (HL) 

Add with Carry Oper- 

Leading A Oper- 

DD8E05 

ADC 

A, (IX+d> 

and to Acc. 

and is Optional 

FD8E05 

ADC 

A, <IY+d) 



8F 

ADC 

A, A 


If d is Omitted 

88 

ADC 

A,B 


0 is Assumed 

89 

ADC 

A,C 



8A 

ADC 

A,D 



8B 

ADC 

A,E 



8C 

ADC 

A,H 



8D 

ADC 

A,L 



CE20 

ADC 

A,n 




ED4A 

ADC 

HL,BC 

Add with Carry Reg. 


ED5A 

ADC 

HL,DE 

Pair to HL 


ED6A 

ADC 

HL,HL 



ED7A 

ADC 

HL,SP 




86 

ADD 

A, (HL) 

Add Operand to Acc. 

Leading A Oper- 

DD8605 

ADD 

A, (IX+d) 


and is Optional 

FD8605 

ADD 

A, (lY+d) 



87 

ADD 

A, A 


If d is Omitted 

80 

ADD 

A,B 


0 is Assvuned 

81 

ADD 

A,C 



82 

ADD 

A,D 



83 

ADD 

A,E 



84 

ADD 

A,H 



85 

ADD 

A,L 



C620 

ADD 

A,n 




09 

ADD 

HL,BC 

Add Reg. Pair to HL 


19 

ADD 

HL,DE 



29 

ADD 

HL,HL 



39 

ADD 

HL,SP 



*:fc:*:***^3»:***A:fe*;i*t:Hr***3fc^:*c************:<t:«cA:*:Ail:*5*:*5fc*****:fc*AA:fc**<c:fc:fc:*c**:fc:fc***ifcofc** 

DD09 

ADD 

IX, BC 

Add Reg. Pair to IX 


DD19 

ADD 

IX, DE 



DD29 

ADD 

IX, IX 



DD39 

ADD 

IX, SP 




FD09 

ADD 

IY,BC 

Add Reg. Pair to lY 


FD19 

ADD 

IY,DE 



FD29 

ADD 

IY,IY 



FD39 

ADD 

IY,SP 



:<lfi*t*******:)»r:fc*:fc!fc*:fc:fc:*c***********’*3*f*:llc***3fc**:#c****:fc***:fc:fc:fc:fc:*:**i*C5fc3fe*:*e:*t*:fc*5te3*f****:fc 

A6 

AND 

A, (HL) 

Logical 'AND' of 

Leading A Oper- 

DDA605 

AND 

A, (IX+d) 

Operand and Acc. 

and is Optional 

FDA605 

AND 

A, (lY+d) 
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Object 


Source 



Code 


Statement 

Operation 

Notes 

A7 

AND 

A, A 

Logial 'AND' of 

Leading A Oper- 

AO 

AND 

A,B 

Operand and Acc. 

and is Optional 

A1 

AND 

A,C 



A2 

AND 

A,D 


If d is Omitted 

A3 

AND 

A,E 


0 is Assumed 

A4 

AND 

A,H 



A5 

AND 

A,L 



E620 

AND 

A,n 



** ie * ic * ic * * * ^ ^ 


CB46 

BIT 

0, (HL) 

Test Bit of Location 

If d is Omitted 

DDCB0546 

BIT 

0, <IX+d) 

or Reg. 

0 is Assumed 

FDCB0546 

BIT 

0, <IY+d> 



CB47 

BIT 

0,A 



CB40 

BIT 

0,B 



CB41 

BIT 

0,C 



CB42 

BIT 

0,D 



CB43 

BIT 

0,E 



CB44 

BIT 

0,H 

- 


CB45 

BIT 

0,L 



CB4E 

BIT 

1, <HL) 



DDCB054E 

BIT 

1, (IX+d) 



FDCB054E 

BIT 

1, (lY+d) 



CB4F 

BIT 

1,A 



CB48 

BIT 




CB49 

BIT 

l,c 



CB4A 

BIT 

1,D 



CB4B 

BIT 

1,E 



CB4C 

BIT 

1,H 



CB4D 

BIT 

1,L 



CB56 

BIT 

2,(HL) 



DDCB0556 

BIT 

2, (IX+d) 



FDCB0556 

BIT 

2, (IX+d> 



CBS 7 

BIT 

2, A 



CB50 

BIT 

2,B 



CB51 

BIT 

2,C 



CBS 2 

BIT 

2,D 



CBS 3 

BIT 

2,E 



CBS4 

BIT 

2,H 



CBSS 

BIT 

2,L 



CBSE 

BIT 

3, (HL) 



DDCBOSSE 

BIT 

3, (IX+d) 



DFCBOSSE 

BIT 

3,(IY+d) 



CBSF 

BIT 

3, A 



CBS8 

BIT 

3,B 



CBS 9 

BIT 

3,C 



CBSA 

BIT 

3,D 



CBSB 

BIT 

3,E 



CBSC 

BIT 

3,H 



CB5D 

BIT 

3,L 



CB66 

BIT 

4, (HL) 



DDCB0S66 

BIT 

4, (IX+d) 



FDCBOS66 

BIT 

4,(IY+d) 
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Object Source 


Code 

Statement 

Operation 

Notes 

CB67 

BIT 

4, A 

Test Bit of Location 

If d is Omitted 

CB60 

BIT 

4,B 

or Reg. 

0 is Assumed 

CB61 

BIT 

4,C 



CB62 

BIT 

4,D 



CB63 

BIT 

4,E 



CB64 

BIT 

4,H 



CB65 

BIT 

4,L 



CB6E 

BIT 

5, (HL) 



DDCB056E 

BIT 

5, <IX+d) 



FDCB056E 

BIT 

5, (lY+d) 



CB6F 

BIT 

5, A 



CB68 

BIT 

5,B 



CB69 

BIT 

5,C 



CB6A 

BIT 

5,D 



CB6B 

BIT 

5,E 



CB6C 

BIT 

5,H 



CB6D 

BIT 

5,L 



CB76 

BIT 

6, (HL) 



DDCB0576 

BIT 

6, (IX+d) 



FDCB0576 

BIT 

6, (IY+d> 



CB77 

BIT 

6, A 



CB70 

BIT 

6,B 



CB71 

BIT 

6,C 



CB72 

BIT 

6 , D 



CB73 

BIT 

6,E 



CB74 

BIT 

6,H 



CB75 

BIT 

6,L 



CB7E 

BIT 

7, (HL) 



DDCB057E 

BIT 

7, (IX+d) 



FDCB057E 

BIT 

7, (lY+d) 



CB7F 

BIT 

7,A 



CB78 

BIT 

7,B 



CB79 

BIT 

7,C 



CB7A 

BIT 

7,D 



CB7B 

BIT 

7,E 



CB7C 

BIT 

7,H 



CB7D 

BIT 

7,L 




DC8405 

CALL 

C,nn 

Call Subroutine at 


1X8405 

CALL 

M,nn 

Location nn if Condi- 


D48405 

CALL 

NC,nn 

tion True 


C48405 

CALL 

NZ,nn 



F48405 

CALL 

P,nn 



EC8405 

CALL 

PE,nn 



E48405 

CALL 

PO,nn 



CC8405 

CALL 

Z,nn 




CD8405 

CALL 

nn 

Unconditional Call to 



Subroutine at nn 

3F CCF Complement Carry Flag 
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Object 


Source 



Code 


Statement 

Operation 

Notes 

BE 

CP 

(HL) 

Compar Operand 

Leading A Oper- 

DDBE05 

CP 

(IX+d) 

with Acc. 

and is Optional 

FDBE05 

CP 

(lY+d) 



BF 

CP 

A 


If d is Ctoitted 

B8 

CP 

B 


0 is Assumed 

B9 

CP 

C 



BA 

CP 

D 



BB 

CP 

E 



BC 

CP 

H 



BD 

CP 

L 



FE20 

CP 

n 




*ifk**it*******'k******:k**it***ic*ftA*it***c**********iiflcic*!******'k**ifk'kit*****it** 


EDA9 CPD Compare Location 

(HL) and Acc. 

Decrement HL and BC 

iic:k*iicitieieTkiiic*ikikitieiticieit*itiitfcieicitiicicieicikieiciciicicitikicitiiciciciicikiciititicikiiciicicitit’k itik kfcftkitfcickkk'kkk 

EDB9 CPDR Compare Location 

<HL) and Acc., Decre- 
ment HL and BC, 

Repeat until BC=0 

fc'kkkfc’kkkkicick’kiicicic'kiticicicic'k'kkii kk 'kk'kkickkkkicfckkitickkicfe kk kkkkkkkkkkkkkkkkkkkkkk 

EDAl CPI Compare Location 

<HL) and Acc., Incre- 
ment HL and Decrement 
BC 

kkkkkkkkkk kk kkkkkkkkkkkkkkkkkkkkkk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

EDBl CPIR Compare Location 

<HL) and Acc., Incre- 
ment HL, Decrement BC, 

Repeat until BC=0 

******************** it-k***** ************ it* ************************* 

2F CPL Complement Acc. (I's 

Complement) 

A**:****** *********** ****************************** A******************** 

27 DAA Decimal Adjust Acc. 

* * k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k 

(HL) Decren^nt Operand If d is Omitted 

(IX+d) 0 is Assumed 

(lY+d) 

A 
B 

BC 
C 
D 
DE 
E 
H 

HL 
IX 
lY 
L 
SP 


35 

DEC 

DD3505 

DEC 

FD3505 

DEC 

3D 

DEC 

05 

DEC 

OB 

DEC 

OD 

DEC 

15 

DEC 

IB 

DEC 

ID 

DEC 

25 

DEC 

2B 

DEC 

DD2B 

DEC 

FD2B 

DEC 

2D 

DEC 

3B 

DEC 
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Object Source 

Code Statement Operation Notes 

F3 DI Disable Interrupts 

102E DJNZ e Decrement B and 

Jump Relative if B=0 

A********************************************************************** 

FB El Enable Interrupts 

ic**-kic*-k*ieicic***1t*t1c*1e1t*******ic****-k**1iic*1c**-k-k******ie**'k**it*ii*****iciiic1cie1iii*c 


E3 

EX 

(SP> ,HL 

Exchange Location 

DDE 3 

EX 

(SP) ,IX 

and (SP) 

FDE3 

EX 

(SP) ,IY 



08 EX AF,AF’ Exchange the Con- 

tents of AF and AF’ 

EB EX DE,HL Exchange the Con- 

tents of DE and HL 

icici(iciii<iiieicfcicic:kiciciefcieie'kiciitiici(iciciciciciiiiiitiitititititicicit'kieiicic:kiciciciticic’kici(ii'kiciciiciicitiicicicic'k’kTkicifi( 

D9 EXX Exchange the Con- 

tents of BC,DE,HL 
with Contents of 
BC ' , DE * , HL ' Respec- 
tively 

it*****'k***c*'kic*****-k**ickitic***'k-k'k-k-k'k**it*'k'k'k***********icic****t************'k 

76 HALT HALT (wait for Inter- 

rupt or Reset) 

ED46 IM 0 Set Interrupt Mode 

EDS 6 IM 1 

ED5E IM 2 


ED78 

IN 

A, (C) 

Load Reg. with Input 


ED40 

IN 

B, (C) 

from Device (C) 


ED48 

IN 

C, (C) 



EDSO 

IN 

D, (C) 



EDS8 

IN 

E, (C) 



ED60 

IN 

H, (C) 



ED68 

IN 

L, (C) 




34 

INC 

(HL) 

Increment Operand 

If d is Omitted 

DD3405 

INC 

(IX+d) 


0 is Assumed 

FD340S 

INC 

(lY+d) 



3C 

INC 

A 



04 

INC 

B 



03 

INC 

BC 



OC 

INC 

C 



14 

INC 

D 



13 

INC 

DE 



1C 

INC 

E 



24 

INC 

H 



23 

INC 

HL 



DD23 

INC 

IX 



FD23 

INC 

lY 




AS 
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Object Source 

Code Statement Operation Notes 

2C INC L Increment Operand 

33 INC SP 

ii;**it*ic************-k********it*****-k********c****'k**it****it*******ic**it*1fk** 

DB20 IN A,{n) Load Acc. with 

Input from Device n 

EDAA IND Load Location <HL) 

with Input from Port 
{ C ) , Decrement HL 
and B 

***ifk*ifkifk*****-k*ic*c****ikic**ic'kic******ifk'k'k*c*1fk*'k'k*********ic******ic****-k** 

EDBA INDR Load Location (HL) 

with Input from Port 
{ C ) , Decrement HL 
and Decrement B, 

Repeat until B=0 

******ifk1t it ******************** **icic*-kifk*ic*'k*'k*****************ic*******'kit 

EDA2 INI Load Location <HL) 

with Input from Port 
(C); Increment HL 
and Decrement B 

*********************************************************************** 

EDB2 INIR Load Location (HL) 

with Input from Port 


(C), Increment HL 
and Decrement B, 
Repeat until B=0 


********** 

’k icie 

'kkkkkkkkkkkkkicickkkkkkkkkk'kkkickkk'kkickkkkkiickkkick'kkkkickicfc kk k 

C38405 

jp 

nn 

Unconditional Jump 

E9 

jp 

(HL) 

to Location 

DDE9 

JP 

(IX) 


FDE9 

JP 

(lY) 


********** 

**** 

kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

DA8405 

JP 

C,nn 

Jump to Location if 

FA8405 

JP 

M,nn 

Condtion True 

D28405 

JP 

NC,nn 


C28405 

JP 

NZ,nn 


F28405 

JP 

P,nn 


EA8405 

JP 

PE,nn 


E28405 

JP 

PO,nn 


CA8405 

JP 

Z,nn 


********** 


k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k 

382E 

JR 

C,e 

Jump Relative to 

302E 

JR 

NC,e 

PC+e if Condition 

202E 

JR 

NZ,e 

True 

282E 

JR 

Z,e 


********** 

**** 

kkkkkkkkkkkkkkkkkk kk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

182E 

JR 

e 

Uncondtional Jump 




Relative to PC+e 


**** 

kkkkkkkkk kk kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk kk kkkkkkkkkk 

02 

LD 

(BC) ,A 

Load Source to 

12 

LD 

(DE) ,A 

Destination 
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Object 

Code 


77 

LD 

70 

LD 

71 

LD 

72 

LD 

73 

LD 

74 

LD 

75 

LD 

3620 

LD 

DD7705 

LD 

DD7005 

LD 

DD7105 

LD 

DD7205 

LD 

DD7305 

LD 

DD7405 

LD 

DD7505 

LD 

DD360520 

LD 

FD7705 

LD 

FD7005 

LD 

FD7105 

LD 

FD7205 

LD 

FD7305 

LD 

FD7405 

LD 

FD7505 

LD 

FD360520 

LD 

328405 

LD 

ED438405 

LD 

ED538405 

LD 

228405 

LD 

DD228405 

LD 

FD228405 

LD 

ED738405 

LD 

OA 

LD 

lA 

LD 

7E 

LD 

DD7E05 

LD 

FD7E05 

LD 

3A8405 

LD 

7F 

LD 

78 

LD 

79 

LD 

7A 

LD 

7B 

LD 

7C 

LD 

ED57 

LD 

7D 

LD 

3E20 

LD 

ED5F 

LD 

46 

LD 

DD4605 

LD 

FD4605 

LD 

47 

LD 

40 

LD 


Source 

Statement 

<HL),A 
{HL>,B 
(HL),C 
(HL) ,D 
<HL) ,E 
(HL),H 
(HL),L 
(HL) ,n 
(IX+d) ,A 
(IX+d),B 
(IX+d) ,C 
(IX+d),D 
(IX+d) ,E 
(IX+d) ,H 
(IX+d ) ,h 
(IX+d) ,n 
(lY+d) ,A 
(IY+d),B 
(lY+d ) ,C 
(IY+d),D 
(lY+d) ,E 
(IY+d),H 
(lY+d) ,L 
(IY+d),n 
(nn) ,A 
(nn) ,BC 
( nn ) , DE 
(nn) ,HL 
(nn) ,IX 
(nn),IY 
(nn) ,SP 
A, (BC) 

A, (DE) 

A, (HLK 
A, (IX+d) 
A, (lY+d) 
A, (nn) 

A, A 
A,B 
A,C 
A,D 
A,E 
A,H 
A, I 
A,L 
A,n 

A, R 

B, (HL) 
B,(IX+d) 
B, (lY+d) 
B,A 

B,B 


Operation 

Load Source to 
Destination 


A7 


Notes 

If d is Omitted 
0 is Assumed 



APPENDIX 
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Object 


Source 


Code 


Statement Operation 

Notes 

41 

LD 

B,C Load Source to 

If d is Omitted 

42 

LD 

B , D Destination 

0 is Assumed 

43 

LD 

B,E 


44 

LD 

B,H 


45 

LD 

B,L 


0620 

LD 

B,n 


ED4B8405 

LD 

BC,<nn) 


018405 

LD 

BC,nn 


4E 

LD 

C, (HL) 


DD4E05 

LD 

C, (IX+d) 


FD4E05 

LD 

C,(IY+d) 


4F 

LD 

C,A 


48 

LD 

C,B 


49 

LD 

C,C 


4A 

LD 

C,D 


4B 

LD 

C,E 


4C 

LD 

C,H 


4D 

LD 

C,L 


0E20 

LD 

C,n 


56 

LD 

D, (HL) 


DD5605 

LD 

D,(IX+d) 


FD5605 

LD 

D, <IY+d) 


57 

LD 

D,A 


50 

LD 

D,B 


51 

LD 

D,C 


52 

LD 

D,D 


53 

LD 

D,E 


54 

LD 

D,H 


55 

LD 

D,L 


1620 

LD 

D,n 


ED5B8405 

LD 

DE,(nn) 


118405 

LD 

DE,nn 


5E 

LD 

E, (HL) 


DD5E05 

LD 

E,(IX+d) 


FD5E05 

LD 

E, (lY+d) 


5F 

LD 

E,A 


58 

LD 

E,B 


59 

LD 

E,C 


5A 

LD 

E,D 


5B 

LD 

E,E 


5C 

LD 

E,H 


5D 

LD 

E,L 


1E20 

LD 

E,n 


66 

LD 

H, (HL) 


DD6605 

LD 

H,(IX+d) 


FD6605 

LD 

H, (lY+d) 


67 

LD 

H,A 


60 

LD 

H,B 


61 

LD 

H,C 


62 

LD 

H,D 


63 

LD 

H,E 


64 

LD 

H,H 
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Object Source 

Code Statement Operation Notes 

65 LD H,L Load Source to If d is Omitted 

2620 LD H,n Destination 0 is Assumed 

2A8405 LD HL,<nn) 

218405 LD HL,nn 

ED47 LD I, A 

DD2A8405 LD IX, (nn) 

DD218405 LD IX, nn 

FD2A8405 LD IY,<nn) 

FD218405 LD IY,nn 

6E LD L,(HL) 

DD6E05 LD L,<IX+d> 

FD6E05 LD L,(IY+d) 

6F LD L,A 

68 LD L,B 

69 LD L,C 

6A LD L,D 

6B LD L,E 

6C LD L,H 

6D LD L,L 

2E20 LD L,n 

ED4F LD R,A 

ED7B8405 LD SP,(nn) 

F9 LD SP,HL 

DDF9 LD SP,IX 

FDF9 LD SP,IY 

318405 LD SP,nn 

EDA8 LDD Load Location (DE) 

v#ith Location (HL) , 

Decrement DE , HL 
and BC 

EDB8 LDDR Load Location (DE) 

with Location (HL). 

Repeat until BC=0 

EDAO LDI Load Location (DE) 

with Location (HL), 

Increment DE, HL, 

Decrement BC 

*****e***'k*!ii****ic**cif*c*i^*it******'k*-k****ifk****'k**********it**tit********it**** 

EDBO LDIR Load Location (DE) 

with Location (HL), 

Increment DE, HL, 

Decrement BC and 
Repeat until BC=0 

ED44 NEC Negate Acc. (2's 

Complement) 

•kit* it**** ****** i(**ic*******t ********************** *****cit**itie*it**-kit*it**it*1c* 

00 NOP No Operation 
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Object 


Source 



Code 


Statement 

Operation 

Notes 

B6 

OR 

A,(HL) 

Logical "OR" of 

Leading A Oper- 

DDB605 

OR 

A, (IX+d) 

Operand and Acc. 

and is Optional 

FDB605 

OR 

A, (lY+d) 



B7 

OR 

A, A 


If d is Omitted 

BO 

OR 

A,B 


0 is Assumed 

B1 

OR 

A,C 



B2 

OR 

A,D 



B3 

OR 

A,E 



B4 

OR 

A,H 



B5 

OR 

A,L 



F620 

OR 

A,n 




iic*****ifk ****************** **************************** ***************** 


ED8B OTDR Load Output Port (C) 

with Location ( HL ) , 

Decrement HL and B, 

Repeat until B=0 

*********************************************************************** 

EDB3 OTIR Load Output Port (C) 

with Location (HL), 

Increment HL, Decre- 
ment B, Repeat until 
B=0 


ED79 

OUT 

(C>,A 

Load Output Port (C) 

ED41 

OUT 

(C) ,B 

with Reg. 

ED49 

OUT 

(C) ,C 


ED51 

OUT 

(C) ,D 


EDS 9 

OUT 

(C),E 


ED61 

OUT 

(C) ,H 


ED69 

OUT 

(C),L 



D320 

OUT 

(n) ,A 

Load Output Port (n) 
with Acc. 

icic ic ii ic fc icit icit ie it fciciit ii fe icicie fc ic ic icic fe ic Hie Hie HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH 

EDAB 

OUTD 


Load Output Port (C) 
with Location (HL), 

Decrement HL and B 

HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH 

EDA3 

OUTI 


Load Output Port (C) 
with Location ( HL ) , 

Increment HL and 

Decrement B 

HHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH 

FI 

POP 

AF 

Load Destination 

Cl 

POP 

BC 

with Top of Stack 

DS 

POP 

DE 


El 

POP 

HL 


DDEl 

POP 

IX 


FDEl 

POP 

lY 



AlO 



APPENDIX A: Z80 MNEMONIC MACHINE INSTRUCTION CODES 


Object 

Code 


Source 

Statement 


F5 

PUSH 

AF 

C5 

PUSH 

BC 

D5 

PUSH 

DE 

E5 

PUSH 

HL 

DDES 

PUSH 

IX 

FDE5 

PUSH 

lY 


CB86 

RES 

0, <HL) 

DDCB0586 

RES 

0, (IX+d) 

FDCB0586 

RES 

0,<IY+d) 

CB87 

RES 

0,A 

CB80 

RES 

0,B 

CB81 

RES 

0,C 

CB82 

RES 

0,D 

CB83 

RES 

0,E 

CB84 

RES 

0,H 

CB85 

RES 

0,L 

CB8E 

RES 

1, (HL) 

DDCB058E 

RES 

1, (IX+d> 

FDCB058E 

RES 

1, <IY+d) 

CB8F 

RES 

1,A 

CB88 

RES 

1,B 

CB89 

RES 

i,c 

CB8A 

RES 

1,D 

CB8B 

RES 

1,E 

CB8C 

RES 

1,H 

CB8D 

RES 

1,L 

CB96 

RES 

2, (HL) 

DDCB0596 

RES 

2, (IX+d) 

FDCB0596 

RES 

2,(IY+d) 

CB97 

RES 

2, A 

CB90 

RES 

2,B 

CB91 

RES 

2,C 

CB92 

RES 

2,D 

CB93 

RES 

2,E 

CB94 

RES 

2,H 

CB95 

RES 

2,L 

CB9E 

RES 

3,(HL) 

DDCB059E 

RES 

3, (IX+d) 

FDCB059E 

RES 

3, (lY+d 

CB9F 

RES 

3, A 

CB98 

RES 

3,B 

CB9A 

RES 

3,D 

CB9B 

RES 

3,E 

CB9C 

RES 

3,H 

CB9D 

RES 

3,L 

CBA6 

RES 

4, (HL) 

DDCB05A6 

RES 

4, (IX+d) 

FDCB05A6 

RES 

4,(IY+d) 

CBA7 

RES 

4, A 

CBAO 

RES 

4,B 

CBAl 

RES 

4,C 


Operation 

Load Source to Stack 


Notes 


Reset Bit b of 
Operand 


If d is Quitted 
0 is Assumed 


All 
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Object 

Code 


Source 

Statement 


CBA2 

RES 

4,D 

CBA3 

RES 

4,E 

CBA4 

RES 

4,H 

CBA5 

RES 

4,L 

CBAE 

RES 

5, (HL) 

DDCB05AE 

RES 

5, <IX+d> 

FDCB05AE 

RES 

5,(IY+d) 

CBAF 

RES 

5, A 

CBA8 

RES 

5,B 

CBA9 

RES 

5,C 

CBAA 

RES 

5,D 

CBAB 

RES 

5,E 

CBAC 

RES 

5,L 

CBB6 

RES 

6, (HL) 

DDCB05B6 

RES 

6,(IX+d) 

FDCB05B6 

RES 

6, (lY+d) 

CBB7 

RES 

6/A 

CBBO 

RES 

6,B 

CBBl 

RES 

6,C 

CBB2 

RES 

6,D 

CBB3 

RES 

6,E 

CBB4 

RES 

6,H 

CBB5 

RES 

6,L 

CBBE 

RES 

7, (HL) 

DDCB05BE 

RES 

7,(IX+d) 

FDCB05BE 

RES 

7,(IY+d) 

CBBF 

RES 

7,A 

CBB8 

RES 

7,B 

CBB9 

RES 

7,C 

CBBA 

RES 

7,D 

CBBB 

RES 

7,E 

CBBC 

RES 

7,H 

CBBD 

RES 

7,L 


C9 

RET 



D8 

RET 

C 

F8 

RET 

M 

DO 

RET 

NC 

CO 

RET 

NZ 

FO 

RET 

p 

E8 

RET 

PE 

EO 

RET 

PO 

C8 

RET 

z 


ED4D 

RETI 



ED45 

RETN 



Operation 

Reset Bit b of 
Operation 


Notes 

If d is Omitted 
0 is Assumed 


Return from 
Subroutine 

Return from 
Subroutine if Condi- 
tion True 


Return from Interrupt 

Return from Non- 
Maskable Interrupt 
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INSTRUCTION CODES 

Object 


Source 



Code 


Statement 

Operation 

Notes 

CB16 

RL 

(HL) 

Rotate Left Through 

If d is Omitted 

DDCB0516 

RL 

(IX+d) 

Carry 

0 is Assumed 

FDCB0516 

RL 

(lY+d) 



CB17 

RL 

A 



CBIO 

RL 

B 



CBll 

RL 

C 



CB12 

RL 

D 



CB13 

RL 

E 



CB14 

RL 

H 



CB15 

RL 

L 



it"ie*ik:k9citfciieifititfciei(fe:ki(i(ici(icicic'iticieicicitieiciciititiciiikiciciefeit-ikiciciicicitic'kiic'kiticicicii±ititit'kiieicTkiciticfcic 

17 

RLA 


Rotate Left Acc. 





Through Carry 



CB06 

RLC 

(HL) 

Rotate Left Circular 

If d is Omitted 

DDCB0506 

RLC 

(IX+d) 


0 i Assumed 

FDCB0506 

RLC 

(lY+d) 



CB07 

RLC 

A 



CBOO 

RLC 

B 



CBOl 

RLC 

C 



CB02 

RLC 

D 



CB03 

RLC 

E 



CB04 

RLC 

H 



CB05 

RLC 

L 




07 

RLCA 


Rotate Left Circ. Acc. 



ED6F 

RLD 


Rotate Digit Left and 



Right between Acc. and 
Location (HL) 


CBIE RR (HL) Rotate Right Through If d is Omitted 

DDCB051E RR (IX+d> Carry 0 is Assumed 

FDCB051E RR (lY+d) 

CBIF RR A 

CB18 RR B 

CB19 RR C 

CBIA RR D 

CBIB RR E 

CBIC RR H 

CBID RR L 

IF RRA Rotate Right Acc. 

Through Carry 

*1fk*-k*1fk***********ic**itifk*'k*'ki(*'kick'kifk**ic******ic*ie****cifkit**ifk**1fk***'k*1fk 

CBOE RRC (HL) Rotate Right Circular 

DDCB050E RRC (IX+d) 

FDCB050E RRC (lY+d) 

CBOF EIRC A 

CB08 RRC B 

CB09 RRC C 

CBOA RRC D 
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Object Source 

Code Statement Operation Notes 

CBOB RRC E Rotate Right Circular 

CBOC RRC H 

CBOD RRC L 

Of RRCA Rotate Right Circular 

Acc. 

ED67 RRD Rotate Digit Right and 

Left Between Acc. and 
Location (EJL) 

ic^itie-kiiit1e'kifkit1c*t* ********************************** fc it* ****1111* ******* Itifkifk 


C7 

RST 

OOH 

Restart to Location 


CF 

RST 

08H 



D7 

RST 

lOH 



DF 

RST 

18H 



E7 

RST 

20H 



EF 

RST 

28H 



F7 

RST 

30H 



FF 

RST 

38H 



:ki^*fc*fcfcTkititTkiciticic*icicitiiiicicicicfcfcicicie*iitikik*:kicitikiciciiiciticikit*iciciititik*fcfcitieieiiciicieicic**icit*icic. 

DE20 

SBC 

A,n 

Subtract Operand 

Leading A Oper- 

9E 

SBC 

A, (HL) 

from Acc. with Carry 

and is Optional 

DD9E05 

SBC 

A, (IX+d) 



FD9E05 

SBC 

A, <IY+d) 


If d is Omitted 

9F 

SBC 

A, A 


0 is Assumed 

98 

SBC 

A,B 



99 

SBC 

A,C 



9A 

SBC 

A,D 



9B 

SBC 

A,E 



9C 

SBC 

A,H 



9D 

SBC 

A,L 



ED42 

SBC 

HL,BC 



ED52 

SBC 

HL,DE 



ED62 

SBC 

HL,HL 



ED72 

SBC 

HL,SP 



fi * ii: ic it it it it it it it it it ie if it fe ic if fc it ic ic ic ie it iic ie i( it Tk it fc it ic * ic ic is fc ic it ii ic it ic ic ic * it: it ie it is ill it ic ie ik itc fc ic ic ik ic ' 

37 

SCF 


Set Carry Flag (C=l) 



CBC6 

SET 

0, <HL) 

Set Bit b of Location 

If d is Omitted 

DDCB05C6 

SET 

0, <IX+d) 


0 is Assumed 

FDCB05C6 

SET 

0, (lY+d) 



CBC7 

SET 

0,A 



CBCO 

SET 

0,B 



CBCl 

SET 

0,C 



CBC2 

SET 

0,D 



CBC3 

SET 

0,E 



CBC4 

SET 

0,H 



CBC5 

SET 

0,L 



CBCE 

SET 

1, (HL) 



DDCB05CE 

SET 

1, (IX+d) 



FDCB05CE 

SET 

l,(IY+d) 



CBCF 

SET 

1,A 
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Object Source 

Code Statement Operation Notes 


CBC8 

SET 

CBC9 

SET 

CBCA 

SET 

CBCB 

SET 

CBCC 

SET 

CBCD 

SET 

CBD6 

SET 

DDCB05D6 

SET 

FDCB05D6 

SET 

CBD7 

SET 

CBDO 

SET 

CBDl 

SET 

CBD2 

SET 

CBD3 

SET 

CBD4 

SET 

CBD5 

SET 

CBD8 

SET 

CBDE 

SET 

DDCB05DE 

SET 

FDCB05DE 

SET 

CBDF 

SET 

CBD8 

SET 

CBD9 

SET 

CBDA 

SET 

CBDB 

SET 

CBDC 

SET 

CBDD 

SET 

CBE6 

SET 

DDCB05E6 

SET 

FDCB05E6 

SET 

CBE7 

SET 

CBEO 

SET 

CBEl 

SET 

CBE2 

SET 

CBE3 

SET 

CBE4 

SET 

CBE5 

SET 

CBEE 

SET 

DDCB05EE 

SET 

FDCB05EE 

SET 

CBEF 

SET 

CBE8 

SET 

CBE9 

SET 

CBEA 

SET 

CBEB 

SET 

CBEC 

SET 

CBED 

SET 

CBF6 

SET 

DDCB05F6 

SET 

FDCB05F6 

SET 

CBF7 

SET 

CBFO 

SET 


1,B Set 

1,C 

1,D 

1,E 

1,H 

1, L 

2, (HL) 

2,(IX+d) 

2 , (lY+d) 

2, A 

2,B 

2,C 

2,D 

2,E 

2,H 

2, L 

3, B 
3,<HL) 

3, (IX+d) 
3,(IY+d) 

3, A 

3,B 

3,C 

3,D 

3,E 

3,H 

3, L 

4, <HL) 

4,<IX+d) 

4, (lY+d) 

4,A 

4,B 

4,C 

4,D 

4,E 

4,H 

4, L 

5, <HL) 

5, <IX+d) 

5, (IY+d> 

5, A 

5,B 

5,C 

5,D 

5,E 

5,H 

5, L 

6, (HL> 

6, (IX+d) 

6, (lY+d) 

6,A 

6,B 


Bit b of Location 


If d is Omitted 
0 is Assun^d 
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Object 


Source 



Code 


Statement 

Operation 

Notes 

CBFl 

SET 

6,C 

Set Bit b of 

If d is Omitted 

CBF2 

SET 

6,D 

Location 

0 is Assumed 

CBF3 

SET 

6,E 



CBF4 

SET 

6,H 



CBF5 

SET 

6,L 



DBFE 

SET 

7,(HL> 



DDCB05FE 

SET 

7, (IX+d> 



FDCB05FE 

SET 

7,(IY+d> 



CBFF 

SET 

7,A 



CBF8 

SET 

7,B 



CBF9 

SET 

7,C 



CBFA 

SET 

7,D 



CBFB 

SET 

7,E 



CBFC 

SET 

7,H 



CBFD 

SET 

7,L 




CB26 

SLA 

(HL) 

Shift Operand Left 

If d is Omitted 

DDCB0526 

SLA 

(IX+d) 

Arithmetic 

0 is Assumed 

FDCB0526 

SLA 

(lY+d) 



CB27 

SLA 

A 



CB20 

SLA 

B 



CB21 

SLA 

C 



CB22 

SLA 

D 



CB23 

SLA 

E 



CB24 

SLA 

H 



CB25 

SLA 

L 




CB2E 

SRA 

(HL) 

Shift Operand Right 

If d is Omitted 

DDCB052E 

SRA 

(IX+d) 

Arithmetic 

0 is Assumed 

FDCB052E 

SRA 

(lY+d) 



CB2F 

SRA 

A 



CB28 

SRA 

B 



CB29 

SRA 

C 



CB2A 

SRA 

D 



CB2B 

SRA 

E 



CB2C. 

SRA 

H 



CB2D 

SRA 

L 




CB3E 

SRL 

(HL) 

Shift Operand Right 

If d is Omitted 

DDCB053E 

SRL 

(IX+d) 

Logical 

0 is Assumed 

FDCB053E 

SRL 

(lY+d) 



DB3F 

SRL 

A 



DB38 

SRL 

B 



CB39 

SRL 

C 



CB3A 

SRL 

D 



CB3B 

SRL 

E 



CB3C 

SRL 

H 



CB3D 

SRL 

L 



AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA* 

96 

SUB 

(HL) 

Subtract Operand 

Leading A Oper- 

DD9605 

SUB 

(IX+d) 

from Acc. 

and is Optional 
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Object 


Source 



Code 


Statement 

Operation 

Notes 

FD9605 

SUB 

(lY+d) 

Subtract Operand 

If d is Omitted 

97 

SUB 

A 

from Acc. 

0 is Assumed 

90 

SUB 

B 



91 

SUB 

C 



92 

SUB 

D 



93 

SUB 

E 



94 

SUB 

H 



95 

SUB 

L 



D620 

SUB 

n 




AE 

XOR 

A, (HL) 

Exclusive "OR" 

Leading A Oper- 

DDAE05 

XOR 

A, (IX+d) 

Operand and Acc. 

and is Optional 

FDAE05 

XOR 

A, (lY+d) 



AF 

XOR 

A, A 


If d is CSnitted 

A8 

XOR 

A,B 


0 is Assumed 

A9 

XOR 

A,C 



AA 

XOR 

A,D 



AB 

XOR 

A,E 



AC 

XOR 

A,H 



AD 

XOR 

A,L 



EE20 

XOR 

A,n 
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APPENDIX B 

ECHELCm SOFTWARE DTOATE FtXOI 


1. PROMJCT NAME & VERSICXi 

2. DSHl NAME DATE 

3. USER'S HARDWARE & SOFTWARE SYSTQl: 


4. REPCXrr TYPE: 

Problem/Possible Error 

Suggested Enhancement 

Document Suggestion 

Other 


5. PERFORMANCE IMPACT: 

Shuts Down System 

Impairs System Performance 

Causes Inconvenience 

Needs Suggested Enhancement 

Other 


6. PROBLEM DESCRIPTION: Please describe the problem concisely and how it 
can be reproduced. If possible, provide your diagnosis and your cure. 
Attach a listing if available. 


7. RETURN FC«M TO: Echelon, Inc. 

101 First Street 
Los Altos, CA 94022 


YOUR INTEREST IN Z-TOOLS IS APPRECIATED I 


B1 
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APPENDIX C 


LABEL 


LABEL 


ZAS FSEUDO-W SUMMARY 


Fseudo-op 

Form 

Definition 

ASEG 


set absolute segment 

C(MON 


set common segment 

CSEG 


set code segment 

DB(DEFB) 

n 

define byte 

DC 

•string' 

define character 

.DEE«ASE 


end .phase 

DS(DEFS) 

expression {.expression} 

define space 

DSEG 


set data segment 

DW(DEFW) 

nn {,nn. ..} 

define word 

ELSE 


conditional assembly 

END 

{expression} 

specifies program starting address 

ENDIF 


end conditional assembly 

ENDM 


end macro 

EQU 

expression 

eqpiate label to a value 

EXIIM 


exit macro 

EXTE<N(EXT) 

syndix)! {.symbol...) 

define external symbols 

.HD64 


assemble HD64180 instructions 

IF 

ejqpression 

conditional assembly 

,IF1 


conditional trueness based on Isb 

,IF16 


conditional trueness based on 16-bits 

.IN(MACLIB) 

{d:}filenajne 

iirclude file 

IRP 

identifier, string {.string...} 

indefinite repeat macro 

IRPC 

identifier, string 

indefinite repeat character macro 

,LALL 


list all macro lines 

LFCOND 


list all false conditionals 

LIST 


resume listing 

LOCAL 

identifier { . identifier. . . } 

define local macro labels 

MACRO 

dummy {.dunwQ^...} 

stored macro definition 

NAME 

modulename 

define module name 


Cl 



LABEL 


ZAS FSEODO-OP ^MIAEOT (con’t) 


Fseudo-op 

Fom 

Definitloii 

(XtG 

expression 

change value of relocation counter 

PAGE 

{expression} 

page definition or eject 

.mASE 

e^qpression 

relocate block of code 

,EWNT 

pass, text 

print text during assembly 

PUBLIC 

symbol {, symbol...} 

define public symbols 

RADIX 

n 

set radix default 

REPT 

e}qpression 

repeat macro 

REQUEST 

filename {.filename...} 

3request library search 

SALL 


suppress macro listing 

SBTTL 

'string' 

define subtitle 

SET(I«FL) 

expression 

set label to a value 

SECOND 


suppress listing of false conditionals 

TITLE 

'string' 

define title 

,XALL 


exclude rmn-code macro lines 

XLIST 


suppress listings 


Legend: items in ( )'s aire aliases; in { }'s, optional 



APPENDIX D 


HITACHI HD64180 MODE 


Object 

Code 


Source 

Statement 


ED3805 

INO 

A, (nn) 

ED0005 

INO 

B , ( nn ) 

ED0805 

INO 

C , ( nn ) 

ED1005 

INO 

D, (nn) 

ED1805 

INO 

E , ( nn ) 

ED2005 

INO 

H, (nn) 

ED2805 

INO 

L, (nn) 

************** 

* ***★ 

icieieitieicicitieieicieicitic 

ED4C 

MLT 

BC 

ED5C 

MLT 

DE 

ED6C 

MLT 

HL 

ED7C 

MLT 

SP 

ititicitit±icititicitititi( 

ED8B 

A A A 

OTDM 



Operation 

Load register with input from 
port ( nn ) . 


icic* * it * ik icic * 

ED9B 

* icit ie ic ic * i( it* 

EDS 3 

idciticikicitikikicik 

ED93 


*********** 

ED3905 

ED0105 

ED0905 

ED1105 

ED1905 

ED2105 

ED2905 

ititiciticikicic'kitit 

ED76 

*********** 

ED3C 

ED04 

EDOC 

EDI 4 

EDIC 

ED24 

ED2C 

ED6405 

ED34 

*********** 

ED7405 


it it ic it it it ie iK it ic ii ic ic ic it ic -k it 

OTDMR 


it'k'kiticititicititicicititititititicicicit'kititrkititicieititit 

Unsigned multiplication of 
each half of the specified 
register pair with the 16-bit 
result going to the specified 
register pair. 

k***************************** 

Load output port (C) with 
location (HL) , decrement HL, 
B, and C. 

icicicicic'kiticiciticiciticickicitieicic'kicieieieiciticitieieic 

Load output port (C) with 
location (HL), decrement HL, 
B, and C. Repeat until B=0. 

ic'kieititi(i(itititititicititiciticieicitititititititicitititicicicitititieititit'ki(kieici(iticiciciti( 

OTIM Load output port (C) with 

location (HL), increment HL 

and C. Decrement B. 
********************************* 

Load output port (C) with 

location (HL), increment HL 
and C. Decrement B. Repeat 
until B=0. 

icicitititititititititititicititititititititicitititititicitititititicititic'kiticici(i( 

(nn),A Load output port (nn) from 

(nn),B register. 

( nn ) , C 
(nn) ,D 
(nn) ,E 
( nn ) , H 
( nn) ,L 

kicickititititicieitititiricititititieicitieiciticic-kiciiiticititicicit'kieiciticide 

Enter sleep mode. 
********************************* 


******************** 

OTIMR 


********* 

OUTO 

OUTO 

OUTO 

OUTO 

OUTO 

OUTO 

OUTO 

********* 


SLP 

icitifkicitititk 

TST 

TST 

TST 

TST 

TST 

TST 

TST 

TST 

TST 

icitititititititit 

TSTIO 


itiekiticitidtititit 

A 

B 

C 

D 

E 

H 

L 

nn 

nn 


Non-destructive AND with 
accumulator and specified 
operand . 


i(i(iticiticititieieiticiticititiiitkitititieieici(iticicititi(ie 

Non-destructive AND of nn and 
the contents of port ( C ) . 


D1 



